← 返回 Skills 市场
pjtf93

Idealista Cli

作者 pjtf93 · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1506
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 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.
使用说明 (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_KEY
  • IDEALISTA_SIGNATURE_SECRET
  • IDEALISTA_OAUTH_CONSUMER_KEY
  • IDEALISTA_OAUTH_CONSUMER_SECRET
  • IDEALISTA_DEVICE_ID
  • IDEALISTA_APP_VERSION
  • IDEALISTA_BASE_URL
  • IDEALISTA_USER_AGENT
  • IDEALISTA_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 --json and check exit code.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install idealista-cli
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /idealista-cli 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug idealista-cli
版本 0.1.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1506 次。

如何安装 Idealista Cli?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install idealista-cli」即可一键安装,无需额外配置。

Idealista Cli 是免费的吗?

是的,Idealista Cli 完全免费(开源免费),可自由下载、安装和使用。

Idealista Cli 支持哪些平台?

Idealista Cli 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Idealista Cli?

由 pjtf93(@pjtf93)开发并维护,当前版本 v0.1.0。

💬 留言讨论