OpenClaw · Skill
Idealista
This skill documents how to query the Idealista API using the local idealista-cli .
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install quifago/idealistaClawHub installer
npx clawhub@latest install quifago/idealistaOpenClaw CLI
openclaw skills install quifago/idealistaDirect OpenClaw install
openclaw install quifago/idealistaWhat this skill does
This skill documents how to query the Idealista API using the local idealista-cli .
Why it matters
Handles OAuth2 token acquisition and caching automatically, so queries run without manual authentication steps each time.
Typical use cases
- 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
Source instructions
idealista
This skill documents how to query the Idealista API using the local idealista-cli.
Local project location
- CLI source (example):
~/idealista-cli
Credentials (client_id / client_secret)
Idealista uses OAuth2 Client Credentials.
Use environment variables (recommended):
IDEALISTA_API_KEY=client_idIDEALISTA_API_SECRET=client_secret
Example:
export IDEALISTA_API_KEY="<CLIENT_ID>"
export IDEALISTA_API_SECRET="<CLIENT_SECRET>"
Or persist them via the CLI:
python3 -m idealista_cli config set \
--api-key "<CLIENT_ID>" \
--api-secret "<CLIENT_SECRET>"
Config file path:
~/.config/idealista-cli/config.json
Token cache:
~/.cache/idealista-cli/token.json
Common commands
Get a token:
python3 -m idealista_cli token
python3 -m idealista_cli token --refresh
Search listings:
python3 -m idealista_cli search \
--center "39.594,-0.458" \
--distance 5000 \
--operation sale \
--property-type homes \
--all-pages \
--format summary
Compute stats:
python3 -m idealista_cli avg \
--center "39.594,-0.458" \
--distance 5000 \
--operation sale \
--property-type homes \
--group-by propertyType
Example queries (natural language)
Use these as “prompt” examples for an agent that calls the CLI:
- "Find a flat in A Coruña under 200.000€"
- "Tell me the average price of a house around here: 39°34'33.5"N 0°30'10.0"W"
- "Búscame un apartamento de 3 habs en Tapia de Casariego para comprar"