idealista

Idealista 是西班牙最大的房地产信息平台，本 Skill 提供了通过命令行工具 idealista-cli 查询其官方 API 的完整文档指南。用户可通过 OAuth2 Client Credentials 认证方式，利用环境变量或本地配置文件存储 API 密钥，执行房产搜索、价格统计等操作。核心用法包括：配置认证信息后，使用 search 命令按地理位置（经纬度）、价格范围、房型等条件检索房源，或使用 avg 命令计算特定区域的平均房价并支持按房型分组统计。

显著优点在于其完全开源（MIT 许可）且文档透明，用户可清晰了解数据流向。命令行界面支持灵活的自然语言查询，适合批量处理和数据集成场景。工具支持多语言输入（如西班牙语、英语），并能输出结构化数据供进一步分析。此外，Token 缓存机制避免了频繁重复认证，提升了使用效率。

潜在局限性包括：该 Skill 本身仅为文档型资产，实际功能完全依赖外部 CLI 工具 idealista-cli，用户需自行安装 Python 环境并克隆仓库。数据来源仅限于 Idealista 平台，主要覆盖西班牙及部分意大利、葡萄牙市场，地理局限性明显。作为个人开发者维护的项目（GitHub Stars 仅 4 个），长期维护稳定性存疑，且缺乏官方技术支持。

适合的目标群体主要是具备技术背景的房产投资者、数据分析师和开发者。需要通过程序化方式批量获取西班牙房产市场数据、进行价格趋势研究或开发房产相关应用的技术用户最为适合。同时适合熟悉 OAuth2 流程、能够安全管理 API 凭据的专业人士。普通消费者若无技术背景，可能难以配置环境和处理命令行操作。

使用风险方面，虽然 Skill 本身无代码执行风险，但依赖的 CLI 工具需要用户自行审查安全性，存在供应链风险。API 密钥以明文形式存储在本地配置文件（~/.config/idealista-cli/config.json）或环境变量中，存在泄露风险，需严格管理文件权限。此外，Idealista API 有调用频率限制，过度查询可能导致账号受限。由于 Idealista 主要面向西班牙市场，非该地区用户可能无法获取有效的 API 访问权限。