/Sole-Retriever-Monitor

A Web Monitor that tracks newly added sneaker raffles on the Sole Retriever website and instantly notifies users via a Discord webhook with comprehensive details.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Logo

Sole Retriever Raffle Monitor

A Web Monitor that Notifies you through Discord Webhook when a New Raffle is Added to Sole Retriever
Report Bug ยท Request Feature

Logo


Please star this repository to increase the awareness of the project for others to use or add to.

Join the Discord Server YasCommunity for Code, Sneakers and Everything in-between! Join here

Logo


Suf Retriever Discord Bot ๐Ÿค–

Suf Retriever is a Discord bot that monitors and notifies users about new sneaker raffles on the Sole Retriever website. It fetches the latest raffle data and sends a notification through a webhook with an embedded message, including the raffle details such as region, delivery method & raffle type.

๐ŸŒŸ Features

  • Monitors New Sneaker Raffles on Sole Retriever
  • Sends notifications with Embedded Messages through a Discord Webhook
  • Supports a Test Command for Manual Testing !test .Type this in the Discord Channel

๐Ÿ›  Setup and Installation

  1. Make Sure you have Python Installed. Then Install the required Python packages in using Command Prompt or Terminal:
    Python and PIP installation guides can be found in the Discord server here.

    pip install -r requirements.txt
    
  2. Open the SufRetriever.py file in an IDE or a Text Editior such as NotePad and add your Discord Bot token:

    A guide on How to get a Bot Token Can be found here.

    LEAVE THE TOKEN WITHIN THE APOSTROPHES

    TOKEN=your_discord_bot_token_here
    

    Replace your_discord_bot_token_here with your actual Discord bot token.

  3. Set the WEBHOOK_URL variable in the script to the webhook URL you created in your Discord server.

    A guide on How to get a Webhook Can be found here.

    LEAVE THE WEBHOOK WITHIN THE APOSTROPHES

    TOKEN=your_discord_webhook_here
    
  4. Open a terminal or command prompt and navigate to the directory containing the bot script using the cd command:

    cd path/to/your/bot/script
    

    Replace path/to/your/bot/script with the actual path to the directory containing the bot script.

    For example, if the script is located in C:\Users\YourUsername\Documents\DiscordBots\SufRetriever, you would type:

    cd C:\Users\YourUsername\Documents\DiscordBots\SufRetriever
    

    Once you are in the correct directory, run the bot script:

    python SufRetriever.py
    

    or if on Mac:

    python3 SufRetriever.py
    

    Replace bot_script.py with the name of the Python script containing the bot code.

๐Ÿ“š Commands

  • !test: Sends a test webhook notification with a pre-defined raffle URL. This command can be used to check if the webhook and embed formatting are working correctly.

๐Ÿ“„ License

Distributed under the GNU General Public License v3.0 License. See GNU General Public License for more information..