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

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

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..