A personal tool for tracking good deals on olx.kz with Telegram notifications.
| Deal notification | Price history chart |
|---|---|
 |
 |
Add your own screenshots to a
docs/folder with the filenames above (screenshot-notification.png,screenshot-history.png) and they will render here.
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt-
Copy
.env.exampleto.env:copy .env.example .env -
Fill in
.env:TELEGRAM_TOKEN— get it from @BotFather (/newbot)MY_CHAT_ID— your own chat id (send/startto @userinfobot)
venv\Scripts\activate
python main.pyThe olx_hunter.db database is created automatically on first run.
Note: the bot's Telegram interface (commands, notifications) is in Russian by design — this is a personal tool.
| Command | Description |
|---|---|
/add iPhone https://olx.kz/... |
Add a search (city/radius filter is applied automatically) |
/list |
List searches with inline delete buttons |
/setprice 1 200000 500000 |
Price range for search id=1 |
/setdiscount 1 30 |
Alert when price is 30% below the rolling average |
/pause 1 / /resume 1 |
Pause / resume a search |
/stats |
Stats for today / week / month |
/history 1 |
Price chart for the last 30 days |
/help |
List of commands |
python -m pytest tests/ -vCreate a start_olx_hunter.bat file next to the project:
@echo off
cd /d "C:\Users\user\Desktop\olx_hunter"
call venv\Scripts\activate
python main.py >> olx_hunter_startup.log 2>&1Option 1 — Startup folder (runs at Windows login):
- Press
Win + R, typeshell:startup, press Enter - Copy
start_olx_hunter.bat(or a shortcut to it) into the folder that opens
Option 2 — Task Scheduler (more robust, runs even without logging in):
- Open Task Scheduler (
taskschd.msc) - Click Create Task
- General tab: set the name to
OLX Hunter, check Run whether user is logged on or not - Triggers tab → New → At startup
- Actions tab → New → Start a program:
- Program: full path to
start_olx_hunter.bat
- Program: full path to
- Click OK, enter your user password if prompted