Idealista房产查询

技能简介

该技能通过idealista-cli命令行工具调用Idealista API，获取西班牙及葡萄牙地区的房产租售信息，支持按地理位置、价格区间、房型等条件检索，并可计算区域均价统计。

能做什么

• 搜索指定坐标半径内的房源列表（出售或出租）
• 按物业类型、卧室数量、价格区间过滤结果
• 计算特定区域的平均房价或租金水平
• 导出结构化数据用于进一步分析

使用说明

1. 安装idealista-cli

git clone https://github.com/quifago/idealista-cli.git
cd idealista-cli
pip install -e .

2. 配置API凭证

通过环境变量设置（推荐）：

export IDEALISTA_API_KEY="你的client_id"
export IDEALISTA_API_SECRET="你的client_secret"

或通过CLI持久化配置：

python3 -m idealista_cli config set \
  --api-key "你的client_id" \
  --api-secret "你的client_secret"

3. 获取访问令牌

python3 -m idealista_cli token

4. 执行房源搜索

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

5. 计算区域均价

python3 -m idealista_cli avg \
  --center "40.4168,-3.7038" \
  --distance 10000 \
  --operation rent \
  --group-by propertyType

输入与输出

见下方输入与输出表格。

项目	内容
输入	地理坐标（纬度,经度）、搜索半径、操作类型（出售/出租）、物业类型、价格区间、卧室数量等过滤条件
输出	房源详细信息（价格、面积、位置、图片链接）、区域均价统计、分组汇总数据，支持JSON或摘要格式
适用人群	关注西班牙及葡萄牙房产市场的投资者、研究人员、租房购房者、本地生活用户
不包含	房源图片直接下载、在线预约看房、合同签署、支付交易、历史价格可视化图表

 

风险提示

• API调用受Idealista速率限制，频繁请求可能导致临时封禁
• OAuth2令牌有效期有限，需定期刷新或配置自动刷新
• 房产数据存在更新延迟，价格信息仅供参考
• 部分区域可能因数据覆盖不足返回空结果
• 商业用途需确认符合Idealista API服务条款

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/quifago/idealista/SKILL.md
来源类型：GitHub仓库