Use this project to look for your Opala or any other car.
It will use OLX platform according to your parameters.
- Running on demand or scheduled via CLI
- Also available as Docker container (run make help for more information)
- Define target region (support multiple separated by comma)
- Define car date range (eg: from 1975 to 1980)
- Using local database (SQLite) to save all information
- Download images into data folder for each offer
- Score based on attributes to find good cars
- Detect new item and skip if it already exists
- Telegram alert - New offer
- Telegram alert - Update price
- MQTT integration - dashboard with statistics
- Dashboard with offers and statistics
- Help
opala:~$ make help- Docker
opala:~$ make build
opala:~$ make start
opala:~$ make status
opala:~$ make log- Script
opala:~$ make run
opala:~$ make sync- Starting with CAR_ is used as filter
- Starting with SCORE_ will give additional points
| VARIABLE | DESCRIPTION | EXAMPLE |
|---|---|---|
| APP_IMAGE | Container image | opala |
| APP_VERSION | Container version | - |
| DAEMON_INTERVAL | Loop interval | 10 |
| DAEMON_LOG | Log level | DEBUG |
| DATA_MOUNT_ENABLE | Enable data | True or False |
| DATA_MOUNT_PATH | Data path | /data |
| CAR_BRAND | Brand | gm-chevrolet |
| CAR_MODEL | Model | opala |
| CAR_TITLE | Offer title | opala |
| CAR_DATE_BEGIN | Year range (begin) | 1975 |
| CAR_DATE_END | Year range (end) | 1980 |
| CAR_KM | Filter by odometer | 90000 |
| CAR_REGION | Target state | sp,mg,rj |
| MQTT_ENABLE | Enable MQTT | True or False |
| MQTT_HOST | MQTT host/IP | localhost |
| MQTT_PORT | MQTT port | 1883 |
| TELEGRAM_ENABLE | Enable Telegram | True or False |
| TELEGRAM_BOT_TOKEN | Telegram token | - |
| TELEGRAM_CHAT_ID | Telegram chat | - |
| HTTPS_PROXY | Proxy address:port | - |
| HTTP_PROX | Proxy address:port | - |
| NO_PROXY | Skip proxy | localhost |
| SCORE_YEAR | Preferred | 1979 |
| SCORE_COLOR | Preferred color | Preto |
| SCORE_DOOR | Preferred doors | 2 |
| SCORE_FUEL | Preferred fuel | Gasolina |
| SCORE_TRANSMISSION | Preferred transmission | Manual |
| SCORE_PRICE | Maximum price | 30000 |
| SCORE_KEYWORD | Words on description | SS,6cc |
| SCORE_KM | Maximum odometer | 80000 |
| MYSQL_SYNC | Enable MySQL sync | True or False |
| MYSQL_DATABASE | DB name | olx |
| MYSQL_HOST | DB host | localhost |
| MYSQL_PORT | DB port | 3306 |
| MYSQL_USER | DB user | - |
| MYSQL_PASS | DB password | - |
- Make sure you have MQTT server running
- Adjust variables based on Configuration
- Install/Configure MQTT client in our Smartphone
- Make sure you have your bot created using @BotFather
curl -s https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getUpdates | jq .result[].message.chat.id- Adjust variables based on Configuration
- Make sure you have MySQL server running
- Adjust variables based on Configuration
Data Visualization using tools:
- MySQL
- Adminer
- Grafana
cd dashboard
docker-compose -f olx.yml up -d
- Support another Database (MySQL)
- Support K8s using helm
- Support multiple cars and brands
- Dashboard and Statistics
- Configure parameters related to score
- Detect good opportunities by score
- Alerts based on parameters