Seminar scraper

This app gets seminar prices and sends alerts when a seminar has a discount.

Configure with .env

1. Create your local config:

cp .env.example .env

2. Edit .env and set:

TELEGRAM_BOT_TOKEN=<YOUR_BOT_TOKEN>
TELEGRAM_CHAT_ID=<YOUR_CHAT_ID>
MODE=telegram
DISCOUNT_ALERT_MODE=keyword
MIN_DISCOUNT_PERCENTAGE=20
PRICE_ALERT_THRESHOLD=550
CATALOG_URL=https://escueladehumanidades.unir.net/oferta-academica/
LOG_TIMEZONE=Europe/Madrid

DISCOUNT_ALERT_MODE options:

• keyword (default): current behavior, sends alert if "descuento" exists in page content.
• increase_over_threshold: sends alert only when the detected % de descuento is at least MIN_DISCOUNT_PERCENTAGE and later increases.

Price monitoring always runs alongside percentage monitoring. It sends an alert when a detected price is below PRICE_ALERT_THRESHOLD, and again only if that price later drops further.

On every cycle, the scraper discovers all seminars linked from CATALOG_URL and checks them in addition to the entries in seminars.txt. Duplicate URLs are checked only once. Container logs include local date, time, timezone and level.

Telegram setup

If you forgot your credentials:

1. Recover or regenerate your bot token with @BotFather:
   • /mybots -> select your bot -> API Token
2. Send a message to your bot in the target chat.
3. Get chat IDs detected by the bot:

.venv/bin/python get_telegram_chat_id.py

The script reads TELEGRAM_BOT_TOKEN from .env (or env vars) and prints available chat_id values.

Run locally

pip install -r requirements.txt
.venv/bin/python main.py

Example for your use case (alert if discount reaches 20% and later increases):

DISCOUNT_ALERT_MODE=increase_over_threshold
MIN_DISCOUNT_PERCENTAGE=20

Seminars to check

Edit seminars.txt to add or remove seminars.

Docker

The container uses a Chrome-compatible TLS/HTTP fingerprint when loading seminar pages so that CDN anti-bot protection does not reject Python's default HTTP client.

Build image

docker build -t seminar_scraper .

Run container with .env

docker run -d --restart always --env-file .env seminar_scraper