摘要
通过任何 AI 助手搜索 Idealista 房地产房源（西班牙、意大利、葡萄牙）。查找出售或出租的公寓和住宅，读取完整房源详情，查询街区数据。4 个工具，无需认证：基于对 Idealista 移动应用的逆向工程。
试试这样问
Idealista 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
仅限自托管。 Idealista 会拒绝来自数据中心 IP 地址的请求，而 AnythingMCP Cloud 运行在数据中心，因此该连接器无法在 AnythingMCP Cloud 上使用。它可以在你自己运行的 AnythingMCP 实例上工作，前提是该实例所在的电脑或服务器使用普通的家庭或办公网络。
Idealista + Microsoft Copilot
通过任何 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 步 —— 在 Microsoft Copilot 中添加 Idealista 连接器
Copilot Studio 从 Microsoft 的云端连接 MCP 服务器，因此无法访问快速启动的 localhost endpoint。要在 Microsoft Copilot 中使用 Idealista，你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例（见上文的 ./setup.sh），并且它所在的网络要被 Idealista 接受。在 Copilot Studio 中打开你的智能体，进入 Tools → Add a tool → New tool → Model Context Protocol，粘贴该实例的 MCP endpoint，并选择 API key，请求头为 X-API-Key。然后把智能体发布到 Microsoft 365 and Microsoft Teams 渠道。
如果无法提供公网实例，请改用在你电脑上运行的客户端：Claude Code、Cursor 或 Gemini CLI 可以直接访问 localhost。
可用工具
| 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
为什么 AnythingMCP Cloud 上没有 Idealista？ Idealista 会拒绝来自数据中心 IP 地址的请求。AnythingMCP Cloud 运行在数据中心，因此每次调用都会失败。部署在家庭或办公网络上的 AnythingMCP 实例通常可以正常使用。
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?