idealista
von quifago
Shopping & E-commerceKurzbeschreibung
Query Idealista API via idealista-cli (OAuth2 client credentials).
Beschreibung
Was dieser Skill macht
Queries the Idealista real estate API using idealista-cli with OAuth2 client credentials. Supports searching property listings by location, operation type, and property type, and computing price statistics across results.
Handles OAuth2 token acquisition and caching automatically, so queries run without manual authentication steps each time.
Wann du ihn einsetzt
- Search for apartments for sale within a radius of given coordinates
- Find rental homes under a price limit in a Spanish city
- Compute average sale prices grouped by property type in an area
- Retrieve all listing pages for a broad area search
- Ask an agent in natural language to find a flat matching specific criteria
Beispiel-Workflow
User asks: Find flats for sale within 5km of Valencia city center
- 1
Resolve the coordinate for Valencia city center
- 2
Run idealista-cli search with --center, --distance 5000, --operation sale, --property-type homes
- 3
Use --all-pages to retrieve the full result set
- 4
Format results using --format summary
A list of flats for sale near Valencia with price, size, and location details
Voraussetzungen
- IDEALISTA_API_KEY environment variable (Idealista OAuth2 client_id)
- IDEALISTA_API_SECRET environment variable (Idealista OAuth2 client_secret)
- Idealista API credentials (OAuth2 client ID and secret, obtained from Idealista)
Installation
clawhub install quifago/idealistaFühre den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.