Python Flathunter-Helper

Disclaimer

This script crawls websites and looks for new offers. Any changes to the webpages can break this script immediately, use with caution.

Setup

Prerequisites

To set up from scratch:

apt install python3
git clone https://github.com/GerRudi/flathunter.git
apt install python3-pip
cp config.yaml.dist config.yaml
nano config.yaml
-> Do your edits to config file
apt install python3-setuptools
apt install python3-wheel

Requirements

Install requirements from requirements.txt to run execute flathunter properly.

pip3 install -r requirements.txt

Usage

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. If not set, try to use
                        '~git-clone-dir/config.yaml'

Configuration

Links

Currently, ebay-kleinanzeigen and immowelt only crawl the first page, so make sure to sort by newest offers.

Bot registration

A new bot can registered with the telegram chat with the BotFather.

Chat-Ids

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

Google API

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.

Contributers

• @NodyHub
• Bene
• @tschuehly
• @Cugu
• @GerRudi