摘要
通过任何 AI 助手搜索 Idealista 房地产房源（西班牙、意大利、葡萄牙）。查找出售或出租的公寓和住宅，读取完整房源详情，查询街区数据。4 个工具，无需认证：基于对 Idealista 移动应用的逆向工程。
试试这样问
Idealista 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
仅限自托管。 Idealista 会拒绝来自数据中心 IP 地址的请求，而 AnythingMCP Cloud 运行在数据中心，因此该连接器无法在 AnythingMCP Cloud 上使用。它可以在你自己运行的 AnythingMCP 实例上工作，前提是该实例所在的电脑或服务器使用普通的家庭或办公网络。
Idealista + Cursor
通过任何 AI 助手搜索 Idealista 房地产房源（西班牙、意大利、葡萄牙）。查找出售或出租的公寓和住宅，读取完整房源详情，查询街区数据。4 个工具，无需认证：基于对 Idealista 移动应用的逆向工程。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
(none — public API)
步骤 1 — 获取凭证
This connector wraps the Idealista mobile app's internal API (app.idealista.it).
Setup: nothing. The mobile API endpoints used here do not require OAuth for read access.
Markets: Idealista operates in Italy, Spain, and Portugal. The locale path segment in URLs (/api/3.5/it/..., /api/3.5/es/..., /api/3.5/pt/...) selects the market. Pass locale as a tool parameter.
What it does NOT do: contact sellers, save searches, post listings. Use this connector to find and read listings; act on them in the Idealista app/site.
…(continued in the in-app connector instructions)
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
- 打开
http://localhost:3000并注册。第一个账户会成为管理员。 - 打开连接器商店（
http://localhost:3000/connectors/store），选择 Idealista，填写它要求的凭证（有些连接器不需要），然后安装。 - 在 MCP Servers 中创建一个服务器，并把 Idealista 连接器分配给它。在该服务器的页面上复制 MCP endpoint（
http://localhost:4000/mcp/<server-id>），并在 API keys 下生成一个密钥。
快速启动只监听 localhost。如果需要一个其他人或云端 AI 客户端也能访问的实例，请克隆仓库并运行 ./setup.sh，它会配置域名、HTTPS 和 OAuth（部署指南）。
步骤 3 — 在 Cursor 中添加连接器
Cursor 运行在你的电脑上，因此可以使用本地 endpoint。把服务器添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：
{
"mcpServers": {
"idealista": {
"url": "http://localhost:4000/mcp/<server-id>",
"headers": { "X-API-Key": "<your-api-key>" }
}
}
}
然后在 Cursor 的 MCP 设置中确认该服务器已启用，并且列出了它的工具。
可用工具
| Tool | What it does |
|---|---|
idealista_search | Search Idealista listings with filters |
idealista_get_listing | Full detail of one Idealista listing by ID — full description, all photos, agency, contact, geocoordinate, energy class, characteristics |
idealista_search_locations | Search for Idealista location IDs (cities, neighborhoods, districts) |
idealista_map_search | Search Idealista listings within a geo bounding box (map-driven search) |
FAQ
Cursor 免费套餐支持自定义 MCP 服务器吗? 是的 — Hobby、Pro 和 Business 套餐均可用。
为什么 AnythingMCP Cloud 上没有 Idealista？ Idealista 会拒绝来自数据中心 IP 地址的请求。AnythingMCP Cloud 运行在数据中心，因此每次调用都会失败。部署在家庭或办公网络上的 AnythingMCP 实例通常可以正常使用。
下一步
这份指南对你有帮助吗?
