{"id":49092351,"url":"https://github.com/miciek335/vinted-listing-tracker","last_synced_at":"2026-04-20T19:06:13.058Z","repository":{"id":307911497,"uuid":"1031056015","full_name":"miciek335/vinted-listing-tracker","owner":"miciek335","description":"Automated Vinted marketplace monitor with multi-platform notifications","archived":false,"fork":false,"pushed_at":"2025-08-02T23:41:25.000Z","size":115,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-03T01:13:27.301Z","etag":null,"topics":["automation","discord","monitoring","playwright","python","telegram","vinted","web-scraping"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miciek335.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-02T23:03:00.000Z","updated_at":"2025-08-02T23:41:29.000Z","dependencies_parsed_at":"2025-08-03T01:13:31.624Z","dependency_job_id":"dc21b168-3b1a-4ca6-b880-98025dfe09ab","html_url":"https://github.com/miciek335/vinted-listing-tracker","commit_stats":null,"previous_names":["miciek335/vinted-listing-tracker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/miciek335/vinted-listing-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miciek335%2Fvinted-listing-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miciek335%2Fvinted-listing-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miciek335%2Fvinted-listing-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miciek335%2Fvinted-listing-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miciek335","download_url":"https://codeload.github.com/miciek335/vinted-listing-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miciek335%2Fvinted-listing-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32061277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","discord","monitoring","playwright","python","telegram","vinted","web-scraping"],"created_at":"2026-04-20T19:06:11.883Z","updated_at":"2026-04-20T19:06:13.052Z","avatar_url":"https://github.com/miciek335.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vinted Listing Tracker 🔍\n\n**Automated Vinted marketplace monitor with multi-platform notifications**\n\nA sophisticated Python script that monitors Vinted searches for new listings and sends instant notifications via Discord, Telegram, and Windows Toast notifications. Features advanced stealth capabilities to avoid detection and includes thumbnail images in all notification types.\n\nWindows Notification\n\n\nTelegram Notification\n\n\n\u003cimg width=\"333\" height=\"363\" alt=\"Telegram Notification\" src=\"https://github.com/user-attachments/assets/dfb538a3-9062-42d8-8ad1-56874ec1b648\" /\u003e\n\n\n## ✨ Features\n\n### 🔔 Multi-Platform Notifications\n- **Discord**: Rich embeds with item images and clickable links\n- **Telegram**: Photo messages with item details and direct links  \n- **Windows Toast**: Native notifications with thumbnails that open listings when clicked\n\n### 🥷 Advanced Stealth Capabilities\n- **User-Agent Rotation**: 5 different realistic browser signatures\n- **Human Behavior Simulation**: Random scrolling, viewport changes, variable timing\n- **Request Randomization**: Intelligent delay patterns to mimic human browsing\n- **Anti-Detection Headers**: Complete browser fingerprint simulation\n\n### 🎯 Smart Monitoring\n- **Product ID Tracking**: Reliable duplicate detection using Vinted's internal IDs\n- **Configurable Limits**: Prevent notification spam (max 10 per search by default)\n- **Persistent Memory**: Remembers seen listings across restarts\n- **Multiple Search Support**: Monitor up to 20+ different searches simultaneously\n\n### ⚙️ Flexible Configuration\n- **JSON Configuration**: Easy search management and notification toggle\n- **Customizable Intervals**: Adjust monitoring fuency (default: 15 minutes)\n- **Individual Notification Control**: Enable/disable each notification method independently\n- **International Support**: Works with all Vinted domains (vinted.pl, vinted.com, vinted.de, etc.)\n- **Unicode Handling**: Full support for international characters and languages\n\n## 🚀 Quick Start\n\n### Preuisites\n- Python 3.10 or higher\n- Windows 10+ (for Windows Toast notifications)\n\n### Installation\n\n1. **Clone the repository**\n2.       https://github.com/miciek335/vinted-listing-tracker.git\n         cd vinted-listing-tracker\n3. **Install dependencies**\n4.       pip install -r requirements.txt\n         python -m playwright install chromium\n5. **Configure your settings**\n   - Create `config.json` based on the example below\n   - Add your notification credentials\n   - Configure your Vinted searches\n\n6. **Run the monitor**\n7.       python vinted_monitor.pyw\n\n## 📋 Configuration\n\n### config.json Example\n      {\n      \"check_interval_minutes\": 15,\n      \"randomization_percent\": 10,\n      \"max_notifications_per_search\": 10,\n      \"notifications\": {\n      \"discord\": {\n      \"enabled\": true,\n      \"webhook_url\": \"YOUR_DISCORD_WEBHOOK_URL\"\n      },\n      \"telegram\": {\n      \"enabled\": true,\n      \"bot_token\": \"YOUR_BOT_TOKEN\",\n      \"chat_id\": \"YOUR_CHAT_ID\"\n      },\n      \"windows\": {\n      \"enabled\": true\n      }\n      },\n      \"searches\": [\n      {\n      \"name\": \"Nintendo Games under 100 PLN\",\n      \"url\": \"https://www.vinted.pl/catalog?search_text=nintendo\u0026price_to=100\u0026order=newest_first\",\n      \"platform\": \"vinted\"\n      },\n      {\n      \"name\": \"Vintage Clothing\",\n      \"url\": \"https://www.vinted.com/catalog?search_text=vintage\u0026order=newest_first\",\n      \"platform\": \"vinted\"\n      }\n      ]\n      }\n\n\n### Setting Up Notifications\n\n#### Discord Webhooks\n1. Go to your Discord server settings\n2. Navigate to Integrations → Webhooks\n3. Create a new webhook\n4. Copy the webhook URL to your config\n\n#### Telegram Bot Setup\n1. Message [@BotFather](https://t.me/botfather) on Telegram\n2. Send `/newbot` and follow the instructions\n3. Save your bot token\n4. Get your chat ID:\n   - Message [@userinfobot](https://t.me/userinfobot)\n   - Or send a message to your bot and visit: `https://api.telegram.org/bot[BOT_TOKEN]/getUpdates`\n\n#### Windows Toast (Automatic)\n- No setup required on Windows 10+\n- Notifications are clickable and open listings directly in your browser\n- Includes thumbnail images downloaded automatically\n\n## 🎯 Creating Vinted Search URLs\n\n1. Visit any Vinted domain (vinted.pl, vinted.com, vinted.de, etc.)\n2. Use the search and filter options to find items you want to monitor\n3. Apply filters like price range, category, condition, etc.\n4. Copy the URL from your browser's address bar\n5. Add to your `config.json` searches array\n\n**Example URLs:**\nBasic search:\nhttps://www.vinted.pl/catalog?search_text=nintendo\u0026order=newest_first\n\nWith price limit:\nhttps://www.vinted.com/catalog?search_text=vintage\u0026price_to=50\u0026order=newest_first\n\nSpecific category:\nhttps://www.vinted.de/catalog?search_text=sneakers\u0026catalog[]=1\u0026order=newest_first\n\nMultiple filters:\nhttps://www.vinted.pl/catalog?search_text=pokemon\u0026price_to=200\u0026catalog[]=2994\u0026order=newest_first\n\n## 🛠️ Requirements\n\n      requests\u003e=2.28.0\n      playwright\u003e=1.44.0\n      win10toast-click\u003e=0.1.2\n\n\n## 🔧 Advanced Configuration\n\n### Stealth Settings\n- `check_interval_minutes`: Time between monitoring cycles (default: 15)\n- `randomization_percent`: Timing variation to appear more human (default: 10%)\n- `max_notifications_per_search`: Prevent spam by limiting notifications per search\n\n### Notification Customization\nEach notification method can be independently:\n- Enabled/disabled with simple true/false flags\n- Configured with different credentials\n- Customized for different notification styles\n\n### Performance Tuning\n- **Memory efficient**: Only stores product IDs, not full listing data\n- **Network optimized**: Reuses browser sessions and implements smart delays\n- **Resource conscious**: Automatic cleanup of temporary image files\n\n## 📊 Monitoring Output\n\nWhen running, the script provides detailed startup information:\n\n\n🔍 VINTED MONITOR STARTING UP (STEALTH MODE)\n📋 CONFIGURED SEARCHES (3):\n\n    Nintendo Games under 100 PLN\n    Platform: VINTED\n    URL: https://www.vinted.pl/catalog?search_text=nintendo...\n\n    Vintage Clothing\n    Platform: VINTED\n    URL: https://www.vinted.com/catalog?search_text=vintage...\n\n📢 NOTIFICATION METHODS:\nDiscord: ✅ Enabled\nTelegram: ✅ Enabled\nWindows Toast: ✅ Enabled (Clickable + Images)\n\n⏰ Check Interval: 15 minutes\n📢 Max Notifications per Search: 10\n🎲 Randomization: ±10%\n🥷 Stealth Features: User-Agent rotation, viewport variation, human-like behavior\n💾 Previously Seen Listings: 1,247\n🚀 Starting monitoring in 3 seconds...\n⏳ 3...\n⏳ 2...\n⏳ 1...\n\n\n## 🌍 International Support\n\nThis tracker works with all Vinted domains worldwide:\n- 🇵🇱 **Poland**: vinted.pl\n- 🇺🇸 **United States**: vinted.com  \n- 🇩🇪 **Germany**: vinted.de\n- 🇫🇷 **France**: vinted.fr\n- 🇬🇧 **United Kingdom**: vinted.co.uk\n- 🇮🇹 **Italy**: vinted.it\n- 🇪🇸 **Spain**: vinted.es\n- And more...\n\nSimply use the appropriate domain in your search URLs!\n\n## 📸 Screenshots\n\n### Windows Toast Notifications\nPlaceholder\n\n### Telegram Notifications  \n\u003cimg width=\"333\" height=\"363\" alt=\"Telegram Notification\" src=\"https://github.com/user-attachments/assets/dfb538a3-9062-42d8-8ad1-56874ec1b648\" /\u003e\n\n### Console Output\n\u003cimg width=\"1476\" height=\"534\" alt=\"obraz\" src=\"https://github.com/user-attachments/assets/882af2d7-d353-40da-8c5b-abe4e98b6400\" /\u003e\n\n\n## 🚨 Important Notes\n\n### Responsible Usage\n- **Respect Vinted's Terms of Service**: Use reasonable monitoring intervals (15+ minutes recommended)\n- **Don't Overload**: The built-in delays and randomization help prevent server strain\n- **Personal Use**: This tool is intended for personal use to track items you're interested in buying\n\n### Rate Limiting \u0026 Stealth\n- Default 15-minute intervals between full monitoring cycles\n- Randomized timing (±10%) to appear more human-like\n- 3-7 second delays between individual searches within a cycle\n- Maximum 10 notifications per search to prevent spam\n- Realistic browser simulation with rotating user agents\n\n### Legal Compliance\nUsers are responsible for:\n- Complying with Vinted's Terms of Service\n- Following applicable local laws and regulations  \n- Using the tool ethically and responsibly\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**Installation Problems**\nIf playwright installation fails:\n\n      python -m playwright install chromium --force\nIf requirements installation fails:\n\n      pip install --upgrade pip\n      pip install -r requirements.txt\n\n\n**Discord Webhook Errors**\n- Verify your webhook URL starts with `https://discord.com/api/webhooks/`\n- Check that your Discord server permissions allow webhooks\n- Test the webhook URL in your browser (should show \"Method Not Allowed\")\n\n**Telegram Bot Issues**\n- Ensure your bot token is correct and active\n- Verify your chat ID is a number, not a username\n- Send a message to your bot first to initiate the chat\n\n**Windows Notification Problems**\n\nReinstall the notification library:\n\n      pip uninstall win10toast-click\n      pip install win10toast-click\n\n\n**No New Listings Found**\n- The script only notifies about listings it hasn't seen before\n- On first run, it marks all current listings as \"seen\"\n- Wait for actual new listings to be posted on Vinted\n\n### Debug Mode\nEnable detailed logging by changing the log level in `vinted_monitor.pyw`:\n\n      logging.basicConfig(level=logging.DEBUG, ...)\n\n\n## 📁 Project Structure\n\n      vinted-listing-tracker/\n      ├── vinted_monitor.pyw # Main monitoring script\n      ├── config.json # Your configuration file\n      ├── requirements.txt # Python dependencies\n      ├── README.md # This documentation\n      ├── LICENSE # MIT License file\n      ├── screenshots/ # Directory for documentation images\n      │ ├── windows-notification.png\n      │ ├── telegram-notification.png\n      │ └── console-output.png\n      ├── seen_listings.json # Auto-generated (stores seen item IDs)\n      └── vinted_monitor.log # Auto-generated (application logs)\n\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how you can help:\n\n### Ways to Contribute\n- 🐛 **Bug Reports**: Open an issue with details about the problem\n- 💡 **Feature Requests**: Suggest new functionality or improvements  \n- 🔧 **Code Contributions**: Submit pull requests with bug fixes or new features\n- 📖 **Documentation**: Help improve the README or add code comments\n- 🌍 **Internationalization**: Test with different Vinted domains and languages\n\n### Development Setup\n1. Fork the repository on GitHub\n2. Clone your fork locally\n3. Create a feature branch: `git checkout -b feature-name`\n4. Make your changes and test thoroughly\n5. Commit with clear messages: `git commit -m \"Add feature description\"`\n6. Push to your fork: `git push origin feature-name`\n7. Submit a pull request with a detailed description\n\n### Code Style\n- Follow existing code formatting and structure\n- Add comments for complex logic\n- Update documentation for new features\n- Test with multiple Vinted domains if applicable\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n### What this means:\n- ✅ **Free to use** for personal and commercial purposes\n- ✅ **Modify and distribute** as you wish\n- ✅ **Private use** allowed\n- ⚠️ **Attribution required** - please credit Maciej J. (MicieK) in your projects\n- ❌ **No warranty** - use at your own risk\n\n## 👨‍💻 Author\n\n**Maciej J. (MicieK)**\n\nIf this project helped you find great deals on Vinted, consider:\n- ⭐ **Starring the repository**\n- 🐛 **Reporting bugs** you encounter\n- 💡 **Suggesting improvements**\n- 🤝 **Contributing code** or documentation\n\n## 🙏 Acknowledgments\n\nSpecial thanks to:\n- **[Playwright](https://playwright.dev/)** - Reliable browser automation framework\n- **[Vinted](https://www.vinted.com/)** - The marketplace platform that makes this tool possible\n- **[Discord](https://discord.com/)** - Webhook API for rich notifications\n- **[Telegram](https://core.telegram.org/bots/api)** - Bot API for mobile notifications\n- **The open-source community** - For the libraries and tools that make this project possible\n\n## ⚠️ Disclaimer\n\nThis tool is created for educational purposes and personal use only. It is not affiliated with, endorsed by, or connected to Vinted in any way. Users are solely responsible for:\n\n- Complying with Vinted's Terms of Service\n- Following applicable laws and regulations in their jurisdiction  \n- Using the tool ethically and responsibly\n- Any consequences resulting from the use of this software\n\nThe authors and contributors provide this software \"as is\" without warranty of any kind and are not liable for any damages or legal issues arising from its use.\n\n---\n\n**⭐ Found this useful? Please star the repository to show your support!**\n\n**📢 Have questions? Open an issue on GitHub and I'll help you get started!**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiciek335%2Fvinted-listing-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiciek335%2Fvinted-listing-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiciek335%2Fvinted-listing-tracker/lists"}