https://github.com/vlourme/vintedpy
Get alerted on Discord when new Vinted articles are published 🛒
https://github.com/vlourme/vintedpy
alerting bot discord python vinted
Last synced: 4 months ago
JSON representation
Get alerted on Discord when new Vinted articles are published 🛒
- Host: GitHub
- URL: https://github.com/vlourme/vintedpy
- Owner: vlourme
- License: gpl-3.0
- Created: 2022-03-03T11:27:57.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-26T06:21:13.000Z (about 1 year ago)
- Last Synced: 2025-03-26T07:26:04.661Z (about 1 year ago)
- Topics: alerting, bot, discord, python, vinted
- Language: Python
- Homepage: https://discord.gg/a3TVmq7XXv
- Size: 40 KB
- Stars: 31
- Watchers: 6
- Forks: 8
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# No more self-host needed! Join our [Discord server](https://discord.gg/a3TVmq7XXv)
> Current state of the project:
> Open-source project is actually stopped, if someone wants to maintain it, I can give maintainer permissions.
> The hosted project is still maintained.
# Vinted Alerting Bot
I decided to open-source by Vinted alerting bot. This bot will inform you via Discord message when new articles that correspond to your criteria are posted on Vinted.
## Changelog
### 09/05/2023 — Bug fixes / Important notice
I haven't updated this bot for like a year. This bot is now back working with following changes:
- Fixed major bug due to Lightbulb change in the way of making embedded messages
- Tokens are now fetched via iOS client instead of web session
- Added an interval parameter in the environments
- Removed tenacity and retrying decorators, this may create an infinite loop.
## How it works?
Once installed, your Discord server will have 3 new commands registered:
```sh
/subscriptions # Display the list of your subscribed searches with ID
/subscribe [channel] [url] # Subscribe to a new search and receive alerts in a channel
/unsubscribe [id] # Unsubscribe of an alert with its ID
```
Once you saved a subscription, the bot will fetch new articles every 30 seconds and alert you in case of new findings!
### Creating bot on Discord Developer
1. Create an application on [Discord Developer](https://discord.com/developers/applications)
2. Create a bot in your application
3. Copy the `.env.example` file to `.env` and copy/paste the token
4. Invite your bot by generating an URL (OAuth2 -> URl Generator)
**Important:** Set the following scopes:
- `bot`
- `applications.commands`
And also set the following bot permission:
- Send Messages
- Embed Links
- Read Messages/View Channels
- Use Slash Commands
### Installation
You must have `python3` and `pip3` installed, Python >3.8 is recommended.
1. Install dependencies: `pip3 install -r requirements.txt`
2. Start the bot: `python3 main.py`
If you want to stop the bot, you can just press **CTRL+C** once. Don't spam **CTRL+C**, it may take a few seconds before it completely stop because of the background thread used to sync items.
### Keeping the bot up all the time
I highly recommend running this bot via a service on Linux distributions.
Here is an example of a Linux service, you will certainly need to change paths:
```ini
[Unit]
Description=vinted_scraper
After=network.target
[Service]
ExecStart=python3 /root/vintedpy/main.py
EnvironmentFile=/root/vintedpy/.env
Restart=on-failure
SyslogIdentifier=vinted
RestartSec=5
TimeoutStartSec=infinity
[Install]
WantedBy=multi-user.target
```