Idealista MCP Server and API by Cotlet

如何将 Idealista 连接到 Claude Code、ChatGPT 和任何 AI Agent

是的，Claude、ChatGPT 和其他 AI Agent 都可以在你的 Idealista 账户中操作。 Idealista 官方的 ChatGPT 应用和 Claude 连接器可搜索西班牙、意大利和葡萄牙待售或待租的房产。Cotlet.dev 可将你已登录的 Idealista 账户连接到任何 AI Agent，让 AI 为你列出、检查和更新房源。

你可以这样提问

列出我所有的在售房源，并显示价格、浏览量和上线天数。

将马德里 Calle Alcalá 120 的公寓价格从 €385,000 降至 €369,000。

改写我在里斯本的两居室房源描述，突出新厨房和露台。先给我看草稿。

我有哪些房源在过去 14 天内没有收到咨询？按价格排序。

将这 6 张新照片添加到我在巴塞罗那的阁楼房源中，并将露台照片放在第一张。

2 分钟内完成连接

在 https://cotlet.dev/app 获取 API 密钥，并将其导出为 COTLET_API_KEY。

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

前往 Settings → Apps → 添加连接器 URL https://cotlet.dev/mcp/v1，然后使用 Cotlet.dev 登录。无需 API 密钥。

Cursor

将此仓库中的 .cursor/mcp.json 复制到你的项目中：

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

在本地运行（stdio）

此仓库是一个真正的 MCP 服务。它通过 stdio 使用 MCP，无需密钥即可列出 Idealista 工具，并将每次工具调用转发到托管的 Cotlet.dev 服务。仍建议使用上面的托管 URL。仅当你的客户端只能启动本地服务时，才使用此方式。

{"mcpServers":{"idealista":{"command":"uvx","args":["idealista-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

也可以使用 Docker：

docker build -t idealista-mcp .
docker run -i --rm -e COTLET_API_KEY idealista-mcp

工具：idealista_guide、idealista_status、idealista_open、idealista_read、idealista_click、idealista_type、idealista_close。如果没有 COTLET_API_KEY，工具调用会返回：“Set COTLET_API_KEY. Get a key at https://cotlet.dev/app”。

命令行

Python 3.10+，无需安装其他内容。通过 PyPI 安装：

pip install idealista-mcp        # or run it once: uvx idealista-mcp connect
idealista-mcp connect

或者直接从此仓库安装：

export COTLET_API_KEY="your-key"
python3 idealista_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 idealista_agent.py status    # is Idealista ready in your Cotlet.dev account
python3 idealista_agent.py guide     # Idealista screens and sign-in link
python3 idealista_agent.py read      # open Idealista, read the page, close the browser
python3 idealista_agent.py tools     # list Cotlet.dev tools
python3 idealista_agent.py serve     # start the stdio MCP server (same as no argument)

Idealista 用户常见问题

Idealista 有 API 吗？

Idealista 没有供你管理自己房源或联系人使用的公共 API（截至 2026 年 10 月 11 日已核实）。它的 Search API 仅供读取，需申请后才能获得；其官方 Claude 和 ChatGPT 应用只能搜索公开房源，且无需登录。Cotlet.dev 可在你已登录的 Idealista 账户中运行，因此你的 AI Agent 无需 API 密钥或代码即可列出和更新你的房源。

如何将 Idealista 连接到 ChatGPT？

Idealista 官方的 ChatGPT 应用可以搜索房产。如需管理自己的房源，请在 ChatGPT 中将 Cotlet.dev 添加为应用（Settings → Apps，连接器 URL 为 https://cotlet.dev/mcp/v1），在 Cotlet.dev Cloud Browser 中登录一次 Idealista，然后用自然语言向 ChatGPT 提问。无需代码，也无需 Idealista API 密钥。

可以用 Claude 操作 Idealista 吗？

可以。Idealista 自己的 Claude 连接器支持房产搜索。如需管理房源，请在 Claude Code 中运行上面的单行 claude mcp add 命令，或者在 Claude 应用中将 https://cotlet.dev/mcp/v1 添加为自定义连接器。然后 Claude 就能在你自己的 Idealista 账户中操作。

有 Idealista MCP 服务吗？

Idealista 官方连接器主要用于搜索西班牙、意大利和葡萄牙的房产。Cotlet.dev 是一个托管的 MCP 服务，可全天候在你自己的 Idealista 账户中为你操作，并支持 Claude、ChatGPT、Cursor、Codex、n8n、Make 和 Zapier。

在以下位置查找

• Cotlet.dev 上的 Idealista
• PyPI 软件包 idealista-mcp
• 分步指南（PDF），发布于 Internet Archive

也适用于

• Mangomint MCP
• Wanderlog MCP
• SmugMug MCP
• Garmin Connect MCP
• Housecall Pro MCP
• Medium MCP
• Crexi MCP
• DistroKid MCP
• LinkedIn MCP
• EstimateOne MCP
• Google Search Console MCP
• Lichess MCP
• Strava MCP
• StreamElements MCP
• Meetup MCP
• AccuRanker MCP
• GetYourGuide MCP
• Riverside MCP
• Udemy MCP
• Faire MCP
• Buildertrend MCP
• 通过 Cotlet.dev 连接的所有应用

---

了解更多：https://cotlet.dev/integrations/idealista-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=idealista

免费开始使用：https://cotlet.dev/signup?app=idealista&utm_source=github&utm_medium=readme&utm_campaign=idealista