🛍️ Topps.com Purchase Automation Bot

Welcome! This tool helps you automate purchases on Topps.com using a simple graphical interface. Follow this "A to Z" guide to get everything set up, even if you've never used Python before!

---

🚀 Quick Start (A to Z Guide)

1️⃣ Step 1: Install Python

The bot runs on Python. If you don't have it:

1. Download: Go to python.org and download the latest version for Windows.
2. Install: Run the installer.

   [!IMPORTANT] Make sure to check the box that says "Add Python to PATH" before clicking Install. This is the most important step!

2️⃣ Step 2: Get the Code

1. If you're a beginner, simply click the green Code button on GitHub and select Download ZIP.
2. Extract the ZIP folder to your computer (e.g., your Desktop).

3️⃣ Step 3: Install Required Libraries

You need to install two libraries (selenium and undetected-chromedriver) for the bot to work.

1. Open the folder where you extracted the code.
2. Click on the address bar at the top of the folder window, type cmd, and press Enter. A black window (terminal) will open.
3. Type the following command and press Enter:

   pip install -r requirements.txt

4. Wait for it to finish. Once done, you're ready!

4️⃣ Step 4: Configure Your Details

Before running the bot, you need to tell it where to ship and how to pay.

1. Open the config.json file using Notepad or any text editor.
2. Fill in your Contact Info (name, address, etc.) and Payment Info (Card number, etc.).
3. Save the file and close it.

5️⃣ Step 5: Run the Bot!

1. In the same black terminal window you opened earlier, type:

   python main.py

2. The Configuration window will pop up!

---

🛠️ How to Use the Bot

Once the window opens:

• Search Mode: Type the name of the product (e.g., "Bowman 2024"). The bot will search, filter for "In Stock Only", and try to buy the first available item.
• Direct Link Mode: Paste the exact URL of the product page.
• Manual Login: When the browser opens, if you are not logged in, the bot will pause. Log in to your Topps account manually, then click "OK" on the prompt to let the bot continue.
• Captchas: If you see a "Verify you are human" check, solve it manually, and the bot will proceed.

---

⚙️ Key Features

• Stealth Mode: Uses undetected-chromedriver to avoid being blocked.
• Persistent Profile: Saves your login so you don't have to log in every time.
• Human-like Typing: Mimics real typing to avoid detection.
• Auto-Retry: Keeps checking if an item is sold out until it becomes available.

---

⚠️ Important Safety Tips

• Stay logged in: Use the "Manual Login" step to ensure you are logged into your account before the bot starts clicking.
• Config file: Keep your config.json safe! It contains your payment information.
• One at a time: Don't run multiple instances of the bot with the same profile at the same time.

---

🐛 Troubleshooting

• "Python is not recognized": You probably forgot to check "Add Python to PATH" during installation. Reinstall Python and make sure that box is checked!
• Chrome Version: If the bot gives an error about Chrome version, simply update your Chrome browser to the latest version.
• Payment Fails: Ensure your card details in config.json are exactly as they appear on your card.

---

⚖️ Disclaimer

This tool is for educational purposes only. Use it responsibly and according to Topps.com's Terms of Service. The developers are not responsible for any account bans or issues.