Idealista房产搜索平台的MCP服务器
*让你的人工智能助手搜索房产，按价格或大小过滤，并直接从聊天中找到位置ID*
______________________________________________________________________
将您的AI助手连接到Idealista。搜索待售或出租的房产，按价格、大小和房间过滤，围绕中心点搜索，并将位置名称解析为ID——所有这些都是通过自然对话完成的。
快速开始
1.安装
从下载二进制文件 发布页面.
或者从源代码构建：
git clone https://github.com/galimru/idealista-mcp.git
cd idealista-mcp
make install2.连接到克劳德桌面
添加 claude_desktop_config.json:
{
"mcpServers": {
"idealista": {
"command": "/path/to/idealista-mcp"
}
}
}然后编辑 ~/.config/idealista-mcp/config.json:
{
"client_key": "your-client-key",
"client_secret": "your-client-secret",
"signing_secret": "your-signing-secret"
}工具
| 工具 | 它做什么 |
|---|---|
search_locations | 按名称前缀搜索位置ID（需要作为输入 search_ads) |
search_ads | 按位置ID或按以下方式搜索房产列表 center + distance，带有价格、大小、房间等过滤器 |
工作流程示例
- 使用
search_locations和prefix=Valencia获取瓦伦西亚的位置ID - 使用
search_ads与返回location_id浏览列表
您还可以使用以下方式按坐标搜索：
center在lat,lng格式distance单位为米
search_ads 接受其中之一 location_id 或 center + distance但不能同时使用。
配置
配置文件
idealista-mcp 将所需凭据存储在 ~/.config/idealista-mcp/config.json. 如果文件不存在，服务器将在首次使用时使用空字符串值创建它。
| 字段 | 必填 | 描述 |
|---|---|---|
client_key | 是 | OAuth客户端密钥（客户端ID） |
client_secret | 是 | OAuth客户端密钥 |
signing_secret | 是 | 用于请求身份验证的原始HMAC-SHA256签名密钥 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
IDEALISTA_DEBUG | 否 | 设置为任何非空值以将HTTP流量记录到stderr |
即使配置文件不完整，服务器也会启动并播发工具。缺少凭据会导致单个工具调用失败，并出现指向配置路径的可操作错误。
持久会话文件存储在 ~/.config/idealista-mcp/session.json它保存了一个稳定的设备标识符（在第一次经过身份验证的调用中生成一次）和缓存的OAuth令牌，因此重新启动时可以重用有效的令牌而无需重新获取。
备注
- 该项目不隶属于Idealista或其母公司。
贡献
欢迎修复错误和进行明显改进。对于任何非琐碎的事情，先打开一个问题。
许可证
麻省理工学院