← 返回 Skills 市场

Idealista

Name: Idealista
Author: quifago

作者 quifago · GitHub ↗ · v0.1.0

cross-platform ✓ 安全检测通过

1909

总下载

当前安装

版本数

在 OpenClaw 中安装

/install idealista

功能描述

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

使用说明 (SKILL.md)

idealista

This skill documents how to query the Idealista API using the local idealista-cli.

Local project location

CLI source (example): ~/idealista-cli

Credentials (client_id / client_secret)

Idealista uses OAuth2 Client Credentials.

Use environment variables (recommended):

IDEALISTA_API_KEY = client_id
IDEALISTA_API_SECRET = client_secret

Example:

export IDEALISTA_API_KEY="\x3CCLIENT_ID>"
export IDEALISTA_API_SECRET="\x3CCLIENT_SECRET>"

Or persist them via the CLI:

python3 -m idealista_cli config set \
  --api-key "\x3CCLIENT_ID>" \
  --api-secret "\x3CCLIENT_SECRET>"

Config file path:

~/.config/idealista-cli/config.json

Token cache:

~/.cache/idealista-cli/token.json

Common commands

Get a token:

python3 -m idealista_cli token
python3 -m idealista_cli token --refresh

Search listings:

python3 -m idealista_cli search \
  --center "39.594,-0.458" \
  --distance 5000 \
  --operation sale \
  --property-type homes \
  --all-pages \
  --format summary

Compute stats:

python3 -m idealista_cli avg \
  --center "39.594,-0.458" \
  --distance 5000 \
  --operation sale \
  --property-type homes \
  --group-by propertyType

Example queries (natural language)

Use these as “prompt” examples for an agent that calls the CLI:

"Find a flat in A Coruña under 200.000€"
"Tell me the average price of a house around here: 39°34'33.5"N 0°30'10.0"W"
"Búscame un apartamento de 3 habs en Tapia de Casariego para comprar"

安全使用建议

This skill is coherent for querying Idealista, but note that it expects you to run a local Python CLI (idealista-cli) which may be obtained from the linked GitHub repo. Before installing or running it: (1) review the upstream repository code or its releases to ensure you trust it; (2) run it in a virtualenv or sandbox if you want to limit impact; (3) avoid hard-coding your client secret in shared shells — use a secure secret store if available; and (4) verify the CLI's config/token file locations (~/.config/idealista-cli/config.json and ~/.cache/idealista-cli/token.json) are protected appropriately.

功能分析

Type: OpenClaw Skill Name: idealista Version: 0.1.0 The skill bundle is benign. It provides instructions to install the `idealista-cli` tool via `git clone` from a specified GitHub repository (https://github.com/quifago/idealista-cli) and then use it to query the Idealista API. API credentials are handled securely via environment variables or a local configuration file. All commands and instructions in `SKILL.md` are directly related to the stated purpose and show no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts against the agent.

能力评估

✓ Purpose & Capability

Name/description, required binaries (python3), and required environment variables (IDEALISTA_API_KEY, IDEALISTA_API_SECRET) match the declared purpose of using the Idealista OAuth2 client-credentials flow via a Python CLI.

✓ Instruction Scope

SKILL.md only instructs the agent to run the local idealista_cli Python module, obtain tokens, run searches, and mentions the CLI config and token cache paths in the user's home directory — all within the scope of querying Idealista. It does not ask for unrelated files, secrets, or to transmit data to unexpected endpoints.

ℹ Install Mechanism

The skill is instruction-only (no code shipped), and SKILL.md metadata suggests installing the upstream idealista-cli by git cloning from GitHub (https://github.com/quifago/idealista-cli). GitHub is a common source and low risk, but running code from that repo requires trusting the upstream project. There is a minor inconsistency: the registry metadata states no install spec while SKILL.md includes an install suggestion.

✓ Credentials

The two required environment variables are the OAuth client_id and client_secret needed to call Idealista's API; this is proportional and expected. No unrelated credentials or broad secrets are requested.

✓ Persistence & Privilege

The skill does not request always-on presence and does not require modification of other skills or system-wide settings. It uses normal agent invocation behavior.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install idealista
安装完成后，直接呼叫该 Skill 的名称或使用 /idealista 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Initial release of the idealista skill. - Provides documentation for querying the Idealista API using idealista-cli. - Details environment variable setup for OAuth2 client credentials. - Includes example CLI commands for token management, searching listings, and computing stats. - Lists prompt examples for natural language agent queries. - Specifies installation method and configuration file locations.

元数据

Slug idealista

版本 0.1.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Idealista 是什么？

Query Idealista API via idealista-cli (OAuth2 client credentials). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1909 次。

如何安装 Idealista？

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

Idealista 是免费的吗？

是的，Idealista 完全免费（开源免费），可自由下载、安装和使用。

Idealista 支持哪些平台？

Idealista 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Idealista？

由 quifago（@quifago）开发并维护，当前版本 v0.1.0。