idealista-cli

What This Skill Does

The idealista-cli is a powerful OpenClaw agent skill designed to interface directly with Idealista, the leading real estate marketplace in Southern Europe. By providing a command-line wrapper around the Idealista API, this skill allows users to perform precise property searches, retrieve location metadata, and inspect individual listing details without manually navigating the web interface. Whether you are building an automated property tracking bot, conducting market analysis on rental prices, or simply scouting for new homes, this skill provides a structured and programmatic way to access real-time data.

The tool is highly configurable, supporting various property types—including homes, rooms, offices, garages, and land—and operations ranging from sales and rentals to transfers. By supporting --json output, the skill integrates seamlessly into larger automation pipelines, making it an essential utility for developers or analysts who require raw data feeds for further processing in scripts or spreadsheets.

Installation

To integrate this skill into your OpenClaw environment, use the internal CLI installer. Run the following command in your terminal:

clawhub install openclaw/skills/skills/pjtf93/idealista-cli

Ensure that you have your Idealista API credentials (API key and OAuth tokens) ready, as they may be required to authenticate requests depending on your environment. If you need to customize the request behavior, you can map your API tokens via standard environment variables such as IDEALISTA_API_KEY or IDEALISTA_BASE_URL.

Use Cases

• Real Estate Market Analysis: Researchers can aggregate listing data to calculate average prices or square meter costs in specific districts.
• Automated Property Scouting: Users can set up cron jobs or OpenClaw triggers to search for new listings matching specific criteria (e.g., bedrooms, price range) and receive alerts.
• Batch Data Extraction: If you need to pull details for a specific set of known property IDs, the listing command allows for rapid, bulk retrieval in machine-readable formats.
• Development and Scripting: Developers can pipe output directly into other tools or databases for custom dashboarding or reporting.

Example Prompts

• "Search for homes for rent in Madrid under 1200 euros and show me the results as a JSON list."
• "Find the location ID for 'Barcelona, Eixample' so I can use it for my automated search scripts."
• "Fetch the full listing details for property ID 987654321 and provide me with the description and URL."

Tips & Limitations

• Rate Limiting: Because this skill relies on an external API, frequent polling may trigger rate limits. Always use the --json flag and parse the output locally rather than repeatedly querying for the same information.
• Error Handling: Always monitor the exit code of your commands. A non-zero exit code signifies that the API request failed, likely due to authentication errors or invalid location queries.
• Filters: Take advantage of the optional filters like --min-price and --bedrooms to reduce the payload size and focus on relevant listings, which helps in staying within API quota limits.