← Back to Skills Marketplace
ImmoScout24 Search
by
mihaimacarie98
· GitHub ↗
· v1.0.0
· MIT-0
99
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install immoscout24-search
Description
Search ImmoScout24 (Germany) real estate listings using their mobile API. Bypasses anti-bot/DataDome protection. Search apartments, houses for buy/rent with...
README (SKILL.md)
ImmoScout24 Search
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
- 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
- Get expose details for interesting listings to check heating type:
python3 scripts/immoscout24-search.py --expose 166875438 --format json
-
Filter based on heating, condition, energy rating, parking.
-
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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: immoscout24-search
Version: 1.0.0
The skill provides a functional Python script to search ImmoScout24 real estate listings via its mobile API. The script (scripts/immoscout24-search.py) uses the requests library to interact with legitimate api.mobile.immobilienscout24.de endpoints and contains no evidence of data exfiltration, persistence, or malicious execution. While SKILL.md includes an instruction to install an unused 'immoscout' package using the --break-system-packages flag, this appears to be a documentation oversight or a remnant of a different implementation rather than an intentional supply-chain attack.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install immoscout24-search - After installation, invoke the skill by name or use
/immoscout24-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: search apartments/houses via IS24 mobile API, get expose details (heating, energy, parking)
Metadata
Frequently Asked Questions
What is ImmoScout24 Search?
Search ImmoScout24 (Germany) real estate listings using their mobile API. Bypasses anti-bot/DataDome protection. Search apartments, houses for buy/rent with... It is an AI Agent Skill for Claude Code / OpenClaw, with 99 downloads so far.
How do I install ImmoScout24 Search?
Run "/install immoscout24-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ImmoScout24 Search free?
Yes, ImmoScout24 Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ImmoScout24 Search support?
ImmoScout24 Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ImmoScout24 Search?
It is built and maintained by mihaimacarie98 (@mihaimacarie98); the current version is v1.0.0.
More Skills