In breve
Cerca annunci immobiliari su Idealista (Spagna, Italia, Portogallo) da qualsiasi assistente AI. Trova appartamenti e case in vendita o in affitto, leggi i dettagli completi degli annunci, consulta i dati del quartiere. 4 strumenti, nessuna autenticazione: ricavato tramite reverse engineering dall'app mobile di Idealista.
Prova a chiedere
Prompt di esempio per Idealista
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
Solo self-hosted. Idealista rifiuta le richieste provenienti da indirizzi IP di data center e AnythingMCP Cloud gira in un data center, quindi questo connettore non è disponibile su AnythingMCP Cloud. Funziona su un'istanza di AnythingMCP che gestisci tu, su un computer o un server con una normale connessione internet di casa o dell'ufficio.
Idealista + Microsoft Copilot
Cerca annunci immobiliari su Idealista (Spagna, Italia, Portogallo) da qualsiasi assistente AI. Trova appartamenti e case in vendita o in affitto, leggi i dettagli completi degli annunci, consulta i dati del quartiere. 4 strumenti, nessuna autenticazione: ricavato tramite reverse engineering dall'app mobile di Idealista.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
(none — public API)
Step 1 — Ottieni le credenziali
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)
Step 2 — Installa l'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
- Apri
http://localhost:3000e registrati. Il primo account diventa amministratore. - Apri lo store dei connettori (
http://localhost:3000/connectors/store), scegli Idealista, inserisci le credenziali richieste (alcuni connettori non ne hanno bisogno) e installalo. - In MCP Servers crea un server e assegnagli il connettore Idealista. Nella pagina del server copia l'MCP endpoint (
http://localhost:4000/mcp/<server-id>) e genera una chiave in API keys.
Il quickstart ascolta solo su localhost. Per un'istanza raggiungibile da altre persone o da client AI nel cloud, clona il repository ed esegui ./setup.sh, che configura dominio, HTTPS e OAuth (guida al deployment).
Passo 3 — Aggiungi il connettore Idealista a Microsoft Copilot
Copilot Studio si collega ai server MCP dal cloud di Microsoft, quindi non raggiunge l'endpoint localhost del quickstart. Per usare Idealista in Microsoft Copilot ti serve un'istanza di AnythingMCP con un indirizzo HTTPS pubblico (vedi ./setup.sh sopra) su una connessione che Idealista accetta. In Copilot Studio apri il tuo agente, vai su Tools → Add a tool → New tool → Model Context Protocol, incolla l'MCP endpoint dell'istanza e scegli API key con l'header X-API-Key. Poi pubblica l'agente nel canale Microsoft 365 and Microsoft Teams.
Se un'istanza pubblica non è un'opzione, usa un client che gira sul tuo computer: Claude Code, Cursor o Gemini CLI raggiungono localhost direttamente.
Tool disponibili
| 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
Perché Idealista non è disponibile su AnythingMCP Cloud? Idealista rifiuta le richieste da indirizzi IP di data center. AnythingMCP Cloud gira in un data center, quindi ogni chiamata fallirebbe. Con un'istanza di AnythingMCP su una connessione di casa o dell'ufficio di solito funziona.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?