Setup & Installation
openclaw skills install @quifago/idealista
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install idealista
What This Skill Does
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.
When to use it
- 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
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Find flats for sale within 5km of Valencia city center
AGENT
- 1Resolve the coordinate for Valencia city center
- 2Run idealista-cli search with --center, --distance 5000, --operation sale, --property-type homes
- 3Use --all-pages to retrieve the full result set
- 4Format results using --format summary
OUTPUT
A list of flats for sale near Valencia with price, size, and location details
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
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)