Resumen
Busca anuncios inmobiliarios de Idealista (España, Italia, Portugal) desde cualquier asistente de IA. Encuentra pisos y casas en venta o alquiler, lee el detalle completo del anuncio, consulta datos de barrios. 4 herramientas, sin autenticación, obtenido mediante ingeniería inversa de la app móvil de Idealista.
Prueba a pedir
Prompts de ejemplo para Idealista
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
Solo autoalojado. Idealista rechaza las peticiones que llegan desde direcciones IP de centros de datos, y AnythingMCP Cloud funciona en un centro de datos, así que este conector no está disponible en AnythingMCP Cloud. Funciona en una instancia de AnythingMCP que ejecutes tú mismo en un ordenador o servidor con una conexión a internet normal de casa o de oficina.
Idealista + ChatGPT
Busca anuncios inmobiliarios de Idealista (España, Italia, Portugal) desde cualquier asistente de IA. Encuentra pisos y casas en venta o alquiler, lee el detalle completo del anuncio, consulta datos de barrios. 4 herramientas, sin autenticación, obtenido mediante ingeniería inversa de la app móvil de Idealista.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
(none — public API)
Paso 1 — Obtener credenciales
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)
Paso 2 — Instalar el 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
- Abre
http://localhost:3000y regístrate. La primera cuenta pasa a ser la administradora. - Abre la tienda de conectores (
http://localhost:3000/connectors/store), elige Idealista, introduce las credenciales que pida (algunos conectores no necesitan ninguna) e instálalo. - En MCP Servers, crea un servidor y asígnale el conector Idealista. En la página del servidor, copia el MCP endpoint (
http://localhost:4000/mcp/<server-id>) y genera una clave en API keys.
El quickstart solo escucha en localhost. Para una instancia a la que puedan llegar otras personas o clientes de IA en la nube, clona el repositorio y ejecuta ./setup.sh, que configura dominio, HTTPS y OAuth (guía de despliegue).
Paso 3 — Añadir el conector en ChatGPT
ChatGPT se conecta a los servidores MCP desde la nube de OpenAI, así que no puede llegar al endpoint localhost del quickstart. Necesitas una instancia de AnythingMCP con una dirección HTTPS pública (ver ./setup.sh arriba) en una conexión que Idealista acepte, y en los pasos de abajo introduces el MCP endpoint de esa instancia en lugar de una URL de Cloud.
ChatGPT se conecta a servidores MCP como apps personalizadas en modo desarrollador (Developer mode), disponible en los planes de pago, no en el gratuito. En los espacios Business y Enterprise puede que un administrador tenga que habilitarlo antes.
- En ChatGPT, abre Settings → Security and login y activa Developer mode.
- Ve a chatgpt.com/plugins y pulsa +.
- Escribe un nombre y una descripción breve, por ejemplo Name:
Idealista. - En Connection, introduce la URL del servidor MCP
https://<your-anythingmcp-domain>/mcp/<server-id>y crea la conexión. - Cuando ChatGPT lo pida, inicia sesión en AnythingMCP (OAuth) y permite el acceso.
Si una instancia pública no es una opción, usa un cliente que se ejecute en tu ordenador: Claude Code, Cursor o Gemini CLI llegan a localhost directamente.
Herramientas disponibles
| 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
¿Funciona el plan gratuito de ChatGPT con conectores MCP personalizados? No. Las conexiones MCP personalizadas necesitan el modo desarrollador, que solo está en los planes de pago.
¿Por qué Idealista no está disponible en AnythingMCP Cloud? Idealista rechaza las peticiones desde direcciones IP de centros de datos. AnythingMCP Cloud funciona en un centro de datos, así que todas las llamadas fallarían. Con una instancia de AnythingMCP en una conexión de casa o de oficina normalmente funciona.
Siguientes pasos
¿Te ha sido útil esta guía?
