This script crawls websites and looks for new flat offers. If there is a new offer, a Telegram Bot will notify you.
Currently the script supports the following websites:
- wg-gesucht.de
- ebay-kleinanzeigen.de
- immobilienscout24.de
- immowelt.de
To set up from scratch:
apt install python3
git clone git@github.com:calbec/flathunter.git
cd flathunter
apt install python3-pip
cp config.yaml.dist config.yaml
nano config.yaml
Now, do your edits to config file in nano editor
apt install python3-setuptools
apt install python3-wheel
Install requirements from requirements.txt to run execute flathunter properly.
pip3 install -r requirements.txt
usage: python3 flathunter.py [-h] [--config CONFIG]
Searches for flats on Immobilienscout24.de and wg-gesucht.de and sends results
to Telegram User
optional arguments:
-h, --help show this help message and exit
--config CONFIG, -c CONFIG
Config file to use, usually 'config.yaml'. If not set, try to use
'~git-clone-dir/config.yaml'
Currently, ebay-kleinanzeigen and immowelt only crawl the first page, so make sure to sort by newest offers.
A new bot can registered with the telegram chat with the BotFather.
To get the chat id (receiver ID), the REST-Api of telegram can be used to fetch the received messages of the Bot.
$ curl https://api.telegram.org/bot[BOT-TOKEN]/getUpdates
To use the distance calculation feature a Google API-Key is needed and requires the Distance Matrix API to be enabled. (This is NOT free) Since this feature is not free, I "disabled" it. Read line 62 in hunter.py to re-enable it.