A powerful CLI tool to query the Idealista real estate API for property listings and market statistics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install idealista
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install idealista using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is idealista?
The idealista skill enables developers and real estate enthusiasts to interface directly with the Idealista API through a streamlined command-line interface. By utilizing the Openclaw Skills framework, users can automate property searches, retrieve detailed listings, and perform market analysis based on geographical coordinates and specific filters like price or property type.
This skill is built around the idealista-cli, providing a robust OAuth2 Client Credentials workflow. It simplifies the complexity of API authentication and data fetching, making it an essential tool for those looking to integrate Spanish, Portuguese, or Italian real estate data into their automated workflows or AI agent interactions.
idealista Use Cases
- Automating property searches based on specific GPS coordinates.
- Monitoring real estate market trends and average prices in specific regions.
- Integrating real estate data into custom dashboards or personal AI assistants through Openclaw Skills.
- Finding investment opportunities by filtering listings by operation type and budget.
How idealista Works
- The skill utilizes OAuth2 client credentials to authenticate with the Idealista API.
- Users configure their API keys and secrets via environment variables or a local config file.
- The CLI fetches an access token and caches it locally for subsequent requests.
- Specific query parameters such as center coordinates, distance, and operation type are passed to the API to retrieve listing data.
- The output is returned in a structured format, such as a summary or a detailed listing view for the user.
idealista Setup
To get started with this skill within the Openclaw Skills ecosystem, follow these steps:
- Clone the repository:
git clone https://github.com/quifago/idealista-cli
- Set your API credentials via environment variables:
export IDEALISTA_API_KEY="<CLIENT_ID>"
export IDEALISTA_API_SECRET="<CLIENT_SECRET>"
- Alternatively, persist configuration via the CLI:
python3 -m idealista_cli config set --api-key "<CLIENT_ID>" --api-secret "<CLIENT_SECRET>"
idealista Data Schema & Taxonomy
The skill manages data across configuration files and temporary caches to ensure efficient API usage. Below is the primary structure:
| Item | Path | Description |
|---|---|---|
| Config File | ~/.config/idealista-cli/config.json | Stores API keys and persistent settings. |
| Token Cache | ~/.cache/idealista-cli/token.json | Stores active OAuth2 access tokens for reuse. |
| Output Formats | CLI Stdout | Returns summary or detailed listings of property data. |
idealista Advanced Features
- Multi-page search support using the --all-pages flag for comprehensive data harvesting.
- Market analysis capabilities with the avg command to compute statistical price averages.
- Support for natural language processing prompts when used as part of Openclaw Skills.
- Flexible grouping of results by property type for comparative market research.
SKILL.md
Loading
Related Openclaw Skills
Google Imagen 3 Portrait Photography
A high-fidelity AI skill designed to generate professional portrait photography and headshots using Google Imagen 3's advanced rendering capabilities.
Prompt Inject Removal
A zero-trust sanitization system designed to strip adversarial instructions and prompt injections from untrusted external content.
zugferd-invoice
A specialized tool for generating ZUGFeRD 2.1 and Factur-X compliant electronic invoices with support for visible multi-page PDF merging.
Economic Calendar
A specialized scraping utility that retrieves macro-economic events and financial indicators from Investing.com without an API key.
PostHog Query
A powerful tool for executing HogQL (ClickHouse) queries against PostHog product analytics data directly from your terminal.
Quote.Trade Operator
Quote.Trade Operator allows AI agents to execute programmable crypto trades and access real-time market data via an AI-native dark-pool DEX.
Featured*
