https://github.com/pythonicshariful/purchase-atomation-topps.com
A Python-based GUI automation bot for purchasing products from Topps.com using Selenium and undetected Chrome driver. Features persistent browser profiles, real-time status updates, and stealth automation capabilities
https://github.com/pythonicshariful/purchase-atomation-topps.com
browser-automation python shopping-bot topps topps-purchase-automation web-automation
Last synced: 10 days ago
JSON representation
A Python-based GUI automation bot for purchasing products from Topps.com using Selenium and undetected Chrome driver. Features persistent browser profiles, real-time status updates, and stealth automation capabilities
- Host: GitHub
- URL: https://github.com/pythonicshariful/purchase-atomation-topps.com
- Owner: pythonicshariful
- Created: 2025-10-22T14:30:02.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-22T14:39:46.000Z (8 months ago)
- Last Synced: 2025-10-22T16:27:38.994Z (8 months ago)
- Topics: browser-automation, python, shopping-bot, topps, topps-purchase-automation, web-automation
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛍️ 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](https://www.python.org/downloads/) 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**:
```bash
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:///c:/Users/pytho/Downloads/purchase-atomation-topps.com/purchase-atomation-topps.com/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:
```bash
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.