← 返回 Skills 市场

ImmoScout24 Search

Name: ImmoScout24 Search
Author: mihaimacarie98

作者 mihaimacarie98 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install immoscout24-search

功能描述

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

使用说明 (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

安全使用建议

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.

功能分析

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.

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install immoscout24-search
安装完成后，直接呼叫该 Skill 的名称或使用 /immoscout24-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: search apartments/houses via IS24 mobile API, get expose details (heating, energy, parking)

元数据

Slug immoscout24-search

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题