realestatebot 0.0.1

(it's free real estate)

realestatebot

tool for ripping Australian real estate listings

summary

uses realestate-data to rip listings from realestate.com.au

this module has not been properly tested, and as such, deviating too far from the examples counts as misuse, and may cause unpredicatable behaviour

i made this for personal use, and i'm sharing it in case someone else finds it useful

setup

git clone https://github.com/silvncr/realestatebot.git

.env (example)

    # comma-separated lists; no spaces; required

POSTCODES="2600,2601,2602"         # main search parameter; more can be added
STATES="ACT,NSW,VIC,QLD,NT,SA,TAS"  # WA is not supported (not sure why)

    # target location (for distance calculations); not required, can be omitted

# idk where this is btw
TARGET_LAT=-35.308056  # latitude (in decimal degrees north)
TARGET_LON=149.124444  # longitude (in decimal degrees east)

    # price range (in AUD); not required, can be omitted; defaults shown below

PRICE_MIN=10000    # minimum price; not validated in-app; can be zero
PRICE_MAX=10000000  # maximum price; not validated in-app

run

cd realestatebot

    # make sure to set up `.env` before running

pip install -r requirements.txt
python realestatebot/__init__.py

library

this is a library, so you can use it in your own projects

pip install realestatebot

try it yourself with this example

from json import dump
from os   import path as os_path
from sys  import path as sys_path

from realestatebot import main

with open(os_path.join(sys_path[0], 'out.json'), 'w') as file:
    dump(main(

        postcodes   = {2600},
        states      = {'ACT'},
        target      = (35.5222, 149.0808),
        price_range = (10_000, 10_000_000),

    )[0].to_dict(orient="records"), file, indent=4)

print('\ndone')

todo

feature	basic	better	finished
code comments	x
code quality		x
documentation	x
error handling	x
examples	x
logging	x
modulation	x
output formats	x
performance		x
reliability	x
requirements	x
search parameters	x
security		x
tests	x