ImmoScout24 Search

Search ImmoScout24 (Germany) real estate listings using their mobile API. Bypasses anti-bot/DataDome protection. Search apartments, houses for buy/rent with...

Security Scan

The skill largely does what it says (queries ImmoScout24 mobile API) and its runtime code matches the described purpose, but there are a few minor inconsistencies and an overstated claim about bypassing anti-bot protection that you should be aware of before installing.

Purpose & Capability

The included Python script performs searches and expose lookups against api.mobile.immobilienscout24.de, which aligns with the skill name/description. However, the SKILL.md tells you to install an 'immoscout' Python package that the bundled script does not import or use, and the README claim 'Bypasses DataDome anti-bot completely' is overstated: the script only sets headers and a random X-Device-Id UUID — not a proven DataDome bypass.

Instruction Scope

Runtime instructions are specific: search and expose commands, output formatting, and example workflows. The instructions don't ask the agent to read unrelated files or secrets. Note the docs encourage writing JSON to /tmp in examples (user-controlled), which is normal.

Install Mechanism

There is no install spec; this is instruction-only with an included script. The only install instruction is a pip command in SKILL.md (pip3 install --break-system-packages immoscout) — this is an unusual pip flag and the named package isn't used by the included script, so installing it is unnecessary and should be avoided unless you verify the package.

Credentials

The skill requests no environment variables or credentials. The script only makes outbound HTTPS requests to ImmoScout24 endpoints and does not access system secrets or other services.

Persistence & Privilege

always is false and the skill does not request persistent system changes or elevated privileges. It does not modify other skills or global agent settings.

Assessment

This skill appears to be what it claims: a simple command-line script that queries ImmoScout24's mobile API. Before running: (1) do not blindly run the pip install line in SKILL.md — the recommended 'immoscout' package is not used by the included script and could be unnecessary; if you need Python packages, install only 'requests' in a virtualenv; (2) the claim about 'completely bypasses DataDome' is likely marketing hyperbole — the script only sets headers and a random device id, which may not defeat anti-bot protections and could violate ImmoScout24 terms of service; (3) review the script yourself (it is included) and prefer running it in an isolated environment (virtualenv or container) and not as root; (4) avoid installing unknown PyPI packages system-wide and verify any external package before use. If you want higher assurance, ask the publisher for provenance (homepage/source repo) or run the script in a sandbox to observe network behavior.

Search and retrieve property listings from ImmoScout24.de using their mobile API. No browser needed — bypasses DataDome anti-bot completely.

Prerequisites

Requires immoscout Python package:

pip3 install --break-system-packages immoscout

Quick Start

Search listings

# Apartments for sale in Passau area, max €300k, 2+ rooms
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --min-rooms 2

# Houses for sale in Passau area, max €350k
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type housebuy --max-price 350000

# JSON output for machine processing
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --format json

Get expose details (heating, energy, parking)

python3 scripts/immoscout24-search.py --expose 166875438
python3 scripts/immoscout24-search.py --expose 166875438 --format json

Expose details include:

• Heizungsart (heating type): Zentralheizung, Fußbodenheizung, Etagenheizung, etc.
• Energieträger (energy source): Erdgas, Fernwärme, Wärmepumpe, Öl, Pellets, etc.
• Garage/Stellplatz (parking): Tiefgarage, Carport, Stellplatz, etc.
• Baujahr (year built), Objektzustand (condition)
• Energieverbrauchskennwert (energy rating)
• Internal fields: obj_heatingType, obj_parkingSpace, obj_condition, obj_purchasePrice

Real Estate Types

Type	Description
apartmentbuy	Apartments for sale (Eigentumswohnung)
housebuy	Houses for sale (Haus kaufen)
apartmentrent	Apartments for rent (Mietwohnung)
houserent	Houses for rent (Haus mieten)

Region Format

Regions use the path format: /de/{bundesland}/{kreis-oder-stadt}

Common regions:

Region	Path
Passau (Kreis)	/de/bayern/passau-kreis
Passau (Stadt)	/de/bayern/passau
München	/de/bayern/muenchen
Berlin	/de/berlin/berlin
Hamburg	/de/hamburg/hamburg
Köln	/de/nordrhein-westfalen/koeln
Frankfurt	/de/hessen/frankfurt-am-main

Parameters

Parameter	Description
--region	Region geocode (required for search)
--type	Real estate type (default: apartmentbuy)
--max-price	Maximum price in EUR
--min-rooms	Minimum number of rooms
--max-pages	Max result pages to fetch (default: 5, 20 items/page)
--expose	Get details for a specific expose ID
--format	Output format: text or json

Typical Workflow for Property Reports

1. Search multiple regions and types:

python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --min-rooms 2 --format json > /tmp/is24-apt.json
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type housebuy --max-price 350000 --format json > /tmp/is24-house.json

2. Get expose details for interesting listings to check heating type:

python3 scripts/immoscout24-search.py --expose 166875438 --format json

3. Filter based on heating, condition, energy rating, parking.

4. Compile report with URLs, prices, heating info, and location details.

Notes

• Uses IS24 mobile API (api.mobile.immobilienscout24.de) — no browser or authentication needed
• Rate limiting is lenient but don't hammer it — add small delays between expose lookups
• Listing URLs follow pattern: https://www.immobilienscout24.de/expose/{id}
• Search returns: id, title, price, area, rooms, address, postcode, published date
• Expose returns: full details including heating, energy, parking, condition, year built