Claude-skill-registry idealista

Query Idealista API via idealista-cli (OAuth2 client credentials).

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/idealista" ~/.claude/skills/majiayu000-claude-skill-registry-idealista && rm -rf "$T"

manifest: skills/data/idealista/SKILL.md

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"