摘要
通过任何 AI 助手搜索 Idealista 房地产房源（西班牙、意大利、葡萄牙）。查找出售或出租的公寓和住宅，读取完整房源详情，查询街区数据。4 个工具，无需认证：基于对 Idealista 移动应用的逆向工程。
试试这样问
Idealista 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
仅限自托管。 Idealista 会拒绝来自数据中心 IP 地址的请求，而 AnythingMCP Cloud 运行在数据中心，因此该连接器无法在 AnythingMCP Cloud 上使用。它可以在你自己运行的 AnythingMCP 实例上工作，前提是该实例所在的电脑或服务器使用普通的家庭或办公网络。
Idealista + Meta Muse
通过任何 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 步 —— 在 Muse 中添加 Idealista 连接器
Muse 从 Meta 的云端连接 MCP 服务器，因此无法访问快速启动的 localhost endpoint。要在 Muse 中使用 Idealista，你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例（见上文的 ./setup.sh），并且它所在的网络要被 Idealista 接受。在 Muse 中打开 Settings → Connectors，选择 Add custom connector，粘贴该实例的 MCP endpoint，并在 Muse 提示时登录 AnythingMCP（使用 OAuth，./setup.sh 默认会配置）。
如果无法提供公网实例，请改用在你电脑上运行的客户端：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 实例通常可以正常使用。
Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?
