← Back to Skills Marketplace
1506
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install idealista-cli
Description
Use the idealista CLI to search Idealista listings by location (city, town, area, street) and fetch listing details. Apply when a user asks for Idealista marketplace data or needs CLI commands/flags for idealista-cli.
README (SKILL.md)
Purpose
Search Idealista listings and fetch listing details.
When to use
- User wants Idealista searches by city/town/area/street.
- User needs listing detail by ad ID.
- User wants JSON output for scripting.
Commands
Location suggestions
idealista locations "\x3Cquery>" --operation \x3Csale|rent|transfer> --property-type \x3Chomes|rooms|offices|garages|land>
Search listings
idealista search "\x3Cquery>" --operation \x3Csale|rent|transfer> --property-type \x3Chomes|rooms|offices|garages|land>
Optional filters:
--page \x3Cn>--limit \x3Cn>--min-price \x3Camount>/--max-price \x3Camount>--min-size \x3Csqm>/--max-size \x3Csqm>--bedrooms \x3Ccount>--order \x3Cfield>/--sort \x3Corder>--location-id \x3Cid>to skip lookup
Listing detail
idealista listing \x3CadId>
JSON output
Add --json to any command:
idealista search "madrid" --json
idealista listing 123456789 --json
Configuration
Defaults are prefilled from APK, override via env vars if needed:
IDEALISTA_API_KEYIDEALISTA_SIGNATURE_SECRETIDEALISTA_OAUTH_CONSUMER_KEYIDEALISTA_OAUTH_CONSUMER_SECRETIDEALISTA_DEVICE_IDIDEALISTA_APP_VERSIONIDEALISTA_BASE_URLIDEALISTA_USER_AGENTIDEALISTA_DNT
Output expectations
- Locations: table or JSON with
locationId, name, type. - Search: table or JSON with id, price, rooms, size, address, location, url.
- Listing: table or JSON with price, rooms, size, address, url, description.
Examples
idealista locations "madrid" --operation sale --property-type homes
idealista search "madrid" --operation rent --property-type homes --limit 20
idealista listing 123456789
Error handling
- Non-zero exit code on failure.
- For scripting, use
--jsonand check exit code.
Usage Guidance
This skill appears to be a documentation/instruction wrapper for an existing idealista CLI — not executable code — but exercise caution before using it: (1) confirm the real idealista-cli package/repository and install it yourself (Node.js 18+); (2) don't set API keys or secrets unless you trust the skill source — the SKILL.md lists sensitive env vars but the registry metadata doesn't declare them as required; (3) clarify what 'APK' means in the configuration defaults; (4) since the skill has no homepage and the source is unknown, prefer a version with a known upstream repository or a published package on npm/GitHub before providing credentials; (5) test commands without credentials (or with limited/test credentials) first and run them in a controlled environment.
Capability Analysis
Type: OpenClaw Skill
Name: idealista-cli
Version: 0.1.0
The skill bundle describes the usage of a pre-installed `idealista-cli` tool for searching real estate listings. The `SKILL.md` content provides clear instructions for using the CLI, including commands and configuration via environment variables specific to the Idealista API. There is no evidence of prompt injection, data exfiltration, malicious execution, persistence mechanisms, or obfuscation. Network access is explicitly stated for `app.idealista.com`, which is consistent with the tool's purpose.
Capability Assessment
Purpose & Capability
The SKILL.md describes CLI commands for idealista-cli and lists relevant API-related env vars (API_KEY, OAUTH secrets, device ID, base URL, etc.) — these are appropriate for an Idealista integration. However the registry metadata claims no required binaries or env vars while SKILL.md explicitly says idealista-cli (Node.js 18+) and network access to app.idealista.com are required. That metadata/manifest mismatch is a minor incoherence.
Instruction Scope
The runtime instructions only show CLI commands and JSON output conventions; they do not instruct the agent to read unrelated files, exfiltrate data, or call endpoints outside app.idealista.com. One ambiguity: 'Defaults are prefilled from APK' is vague and should be clarified, but it does not itself expand scope.
Install Mechanism
This is an instruction-only skill with no install spec or code files, so nothing will be written to disk by the skill itself. The SKILL.md expects the user to have installed idealista-cli (Node.js 18+), which is a normal external dependency; no suspicious download URLs or installers are present.
Credentials
SKILL.md lists multiple sensitive environment variables (IDEALISTA_API_KEY, IDEALISTA_SIGNATURE_SECRET, OAUTH consumer key/secret, DEVICE_ID, etc.). While these are plausible for a private API client, the registry metadata declares no required env vars and the skill does not make them mandatory — the discrepancy should be noted. Because these variables are secrets, users should not set them unless they trust the source and understand how the CLI will use them.
Persistence & Privilege
The skill does not request persistent installation, always:true is not set, and it is user-invocable only. It does not attempt to modify other skills or system-wide settings. Default autonomous invocation is allowed (platform default) but not combined with other high-risk privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install idealista-cli - After installation, invoke the skill by name or use
/idealista-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of idealista-cli skill.
- Enables search of Idealista listings by location (city, area, street), including detailed listing queries.
- Offers commands for location suggestions, searching listings, and fetching listing details.
- Supports filtering by operation, property type, price, size, bedrooms, and sorting options.
- Provides optional JSON output for scripting.
- Allows configuration via environment variables.
- Returns results in table or JSON format as requested.
Metadata
Frequently Asked Questions
What is Idealista Cli?
Use the idealista CLI to search Idealista listings by location (city, town, area, street) and fetch listing details. Apply when a user asks for Idealista marketplace data or needs CLI commands/flags for idealista-cli. It is an AI Agent Skill for Claude Code / OpenClaw, with 1506 downloads so far.
How do I install Idealista Cli?
Run "/install idealista-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Idealista Cli free?
Yes, Idealista Cli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Idealista Cli support?
Idealista Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Idealista Cli?
It is built and maintained by pjtf93 (@pjtf93); the current version is v0.1.0.
More Skills