核心用法
idealista-cli 是 Idealista 西班牙房产平台的非官方 CLI 工具，主要功能包括三类：
- 位置建议：
idealista locations "<query>"获取城市/街道的 locationId - 房源搜索：
idealista search "<query>"支持价格、面积、卧室数等多维度过滤 - 详情获取：
idealista listing <adId>提取单套房源完整信息
所有命令支持 --json 输出，便于脚本集成与数据流水线。
显著优点
- 地理精度高：支持街道级别搜索，超越多数房产 API 的城市级限制
- 过滤器丰富：价格区间、面积、卧室数、排序方式等参数齐全
- 输出格式灵活：表格可读性好，JSON 便于程序化解析
- MIT 开源：可自由修改与二次分发
潜在局限
- 非官方工具：Idealista 未提供公开 API，cli 依赖逆向工程，存在接口变动风险
- 认证复杂：需配置 8 项环境变量（API Key、OAuth、Device ID 等），上手门槛高
- 地域局限：仅覆盖 Idealista 运营区域（西班牙、意大利、葡萄牙为主）
- 无数据持久化：每次调用独立请求，无本地缓存机制
适合人群
- 房产数据分析师、投资者需批量抓取西班牙/南欧市场房源
- 开发者构建房产比价、监控机器人等自动化工具
- 对 CLI 效率优先的技术型用户
常规风险
- 服务稳定性：非官方接口可能随时失效或限流
- 合规灰色地带：抓取行为可能违反 Idealista ToS，存在账号封禁风险
- 数据准确性：房源实时性依赖平台同步，建议关键决策前人工复核