Skip to content
TakoAPI
Back to skills

idealista

by quifago

Shopping & E-commerce
1.6kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

Description

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

INPUT

User asks: Find flats for sale within 5km of Valencia city center

AGENT
  1. 1

    Resolve the coordinate for Valencia city center

  2. 2

    Run idealista-cli search with --center, --distance 5000, --operation sale, --property-type homes

  3. 3

    Use --all-pages to retrieve the full result set

  4. 4

    Format results using --format summary

OUTPUT

A list of flats for sale near Valencia with price, size, and location details

Requirements

  • 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)

Installation

clawhub install quifago/idealista

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links