idealista

⚠Review·Scanned 2/18/2026

This skill documents querying the Idealista API via the local idealista-cli and provides example python3 -m idealista_cli commands. It instructs running shell commands, using/storing credentials in IDEALISTA_API_KEY/IDEALISTA_API_SECRET, and writing tokens to ~/.cache/idealista-cli/token.json, which triggers network calls.

from clawhub.ai·vaec042f·2.0 KB·0 installs
Scanned from 0.1.0 at aec042f · Transparency log ↗
$ vett add clawhub.ai/quifago/idealistaReview findings below

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_id
  • IDEALISTA_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"