AI导哈

房产搜索服务

通过自然语言对话连接AI助手与Idealista房产平台，实现房产买卖租赁搜索、价格面积筛选及位置ID解析功能。

  • by galimru
  • Go
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 galimru/idealista-mcp

使用说明

Idealista房产搜索平台的MCP服务器

让你的人工智能助手搜索房产，按价格或大小过滤，并直接从聊天中找到位置ID

将您的AI助手连接到Idealista。搜索待售或出租的房产，按价格、大小和房间过滤，围绕中心点搜索，并将位置名称解析为ID——所有这些都是通过自然对话完成的。

快速开始

1.安装

从下载二进制文件 发布页面.

或者从源代码构建：

git clone https://github.com/galimru/idealista-mcp.git
cd idealista-mcp
make install

2.连接到克劳德桌面

添加 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，带有价格、大小、房间等过滤器

工作流程示例

  1. 使用 search_locations 和 prefix=Valencia 获取瓦伦西亚的位置ID
  2. 使用 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或其母公司。

贡献

欢迎修复错误和进行明显改进。对于任何非琐碎的事情，先打开一个问题。

许可证

麻省理工学院

相关 MCP