noyainrain/flatdir

Web aggregator of flat ads from different real estate companies.

flatdir's Issues

Include flat rent

Include rent data from real estate companies for flats.

Depends on #12.

Add more companies for Berlin

Expand the scope of the Berlin Flat Directory and configure more real estate companies in places/berlin.ini.

If you would like to contribute and add a company from the selection below, please claim it by leaving a short comment. 💖

Selection of Real Estate Companies

Realtors:

• https://www.immobman.de/ff/immobilien/?schema=flat_rent&price=&ffpage=1&sort=date
• https://www.klingerimmobilien.de/immobilienangebote/mietobjekte/ (JS)
• https://www.agas-immobilien.de/immobilien (JS)
• https://imms-immobilien.de/mietobjekte/ (JS)
• https://www.trialog-gmbh.com/wohnungen.xhtml?f[2084-6]=miete&f[2084-8]=wohnung
• https://www.von-poll.com/de/search
• https://berliner-raumpiloten.de/immobilien/suche/?location=Berlin&marketing_type=11&category=16
• https://berlinso-immo.de/immobilien-wohnung/ (JS)

Property managers:

• https://tolle-hausverwaltung.de/immobilien?fields%5Bgeneral_objektart%5D=wohnung
• https://www.vonkathen-hausverwaltung.de/vermietung (hardcoded)
• https://www.harry-gerlach.de/wohnung-mieten-berlin/
• https://www.grandcityproperty.de/wohnungssuche (JS)

Mini Dictionary

• Wohnung: Flat / Apartment
• Immobilie: Real estate
• Gewerbe: Business
• Miete: Rent
• Kauf: Sale
• Zimmer: Rooms
• Lage: Location
• Aktuell: Current
• Mitte, Friedrichshain-Kreuzberg, Pankow, Charlottenburg-Wilmersdorf, Spandau, Steglitz-Zehlendorf, Tempelhof-Schöneberg, Neukölln, Treptow-Köpenick, Marzahn-Hellersdorf, Lichtenberg, Reinickendorf: Districts of Berlin

Clean up location data for Berlin

Remove superfluous location data for Berlin, e.g. the street address.

Depends on #7.

Enable default value for fields

Some real estate companies do not output certain fields, either in general (e.g. no location) or in specific circumstances (e.g. no room count for business space). Make it possible to supply a default value for missing fields, given by path:pattern:default, e.g. p/span[1]::Berlin.

Support local format for numeric fields

Parse numeric fields according to the configured locale, respecting the decimal and grouping separator.

Respect base tags

If a document defines a base tag, take it into account when resolving extracted ad URLs.

Draft

class Company:
    """
    URL field of an ad. The extracted URL is resolved against the base URL of the document (for HTML
    see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base).
    """
    url_path: str

Implementation hints: Company._parse_html() could search for a <base> tag and join it with each
ad URL. A minimal HTML document containing a <base> tag could be used for a unit test.

Parsing www.homesk.de fails

Parsing www.homesk.de fails with No div/div/div[2]/div/div[1]/div/div[1]/h3 in <a href="/Rent/RentalFlatDetails/a25f1be3-0607-47e5-998a-7b2a397288a6" title="Delbrückstraße 40" class="tile tile-sm-640px-480px tile-md-960px-480px tile-lg-1280px-480px" />.

Wrong number of rooms for www.trialog-gmbh.com

"Attraktive Single-Wohnung" shows 588 rooms instead of 1.

Fix parsing of immosuche.degewo.de

Parsing immosuche.degewo.de fails with No a/div[2]/ul[2]/li[1]/span in <article class="article-list__item article-list__item--immosearch" />.

Enable text pattern for fields

Some real estate companies output rather verbose field values, e.g. a location including the street address or a room count with flavor text. Make it possible to filter fields with a regular expression, given by path:pattern, e.g. p/span[1]:[^,]*.

Draft

## Real estate company.
##
## A *field* describes the extraction of data from a document and has the form
## `path:pattern:default`. *path* locates the target element. *pattern* is an optional regular
## expression to search the element for.
##
## Future reference: Optionally, a *default* value is used if the field is missing.
##[company:example.org]
## URL field of an ad
#url_path = a/@href
## Title field of an ad
#title_path = a/h2
## Location field of an ad
#location_path = p/span[1]:[^,]*
## Rooms field of an ad
#rooms_path = p/span[2]

Create Hannover Flat Directory

Create a flat directory for Hannover.

We are looking for a volunteer to create and maintain a config file with a minimum of two real estate companies for Hannover. Documentation is available in default.ini, berlin.ini can be used as a template and we are happy to help with any questions. 😊