Agent skill

idealista

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

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/idealista

Metadata

Additional technical details for this skill

clawdbot 
{
    "emoji": "\ud83c\udfe0",
    "install": [
        {
            "id": "git",
            "url": "https://github.com/quifago/idealista-cli",
            "bins": [
                "python3"
            ],
            "kind": "git",
            "label": "Install idealista-cli (git clone)"
        }
    ],
    "requires": {
        "env": [
            "IDEALISTA_API_KEY",
            "IDEALISTA_API_SECRET"
        ],
        "bins": [
            "python3"
        ],
        "primaryEnv": "IDEALISTA_API_KEY"
    }
}

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:

bash
export IDEALISTA_API_KEY="<CLIENT_ID>"
export IDEALISTA_API_SECRET="<CLIENT_SECRET>"

Or persist them via the CLI:

bash
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:

bash
python3 -m idealista_cli token
python3 -m idealista_cli token --refresh

Search listings:

bash
python3 -m idealista_cli search \
  --center "39.594,-0.458" \
  --distance 5000 \
  --operation sale \
  --property-type homes \
  --all-pages \
  --format summary

Compute stats:

bash
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"

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results