Piattaforma API e MCP CASAFARI: dati immobiliari per agenti IA
Collega Claude, ChatGPT e client MCP al property graph di CASAFARI su 16 paesi (Stati Uniti: ingresso in corso, Stati selezionati, solo immobili commerciali, con Claro AI) con accesso OAuth, strumenti quasi tutti in sola lettura e un unico account.
La piattaforma self-service platform.casafari.com consente a professionisti e agenti IA di accedere direttamente al property graph di CASAFARI, l'indice di dati immobiliari su 16 paesi, Italia compresa. Attraverso un unico account e l'autenticazione OAuth 2.1 nel browser senza chiavi da copiare, è possibile interrogare strumenti, quasi tutti in sola lettura, per valutazioni, analisi di mercato e ricerca. Il piano Free offre 1.000 token per i primi 30 giorni senza carta di credito (fonte: developers.casafari.com, ottobre 2026).
Che cos'è la piattaforma API e MCP di CASAFARI
Nel settore immobiliare italiano, sviluppatori proptech, responsabili dati di reti e agenzie, fondi d'investimento e periti utilizzano sempre più spesso modelli linguistici per automatizzare l'analisi di mercato. Per collegare un agente IA a una fonte dati di livello professionale occorre chiarezza su tre aspetti: la copertura geografica effettiva, la gestione dei costi e il controllo sugli accessi.
La piattaforma self-service di CASAFARI risponde a queste esigenze offrendo un punto d'accesso unico per persone e assistenti artificiali. Il sistema si basa sul property graph di CASAFARI, una struttura dati pulita e deduplicata che traccia immobili residenziali e commerciali, in vendita e in affitto, assegnando a ciascun immobile un unico record con l'intera cronologia dei prezzi e delle variazioni di stato (fonte: la pagina su come è costruito il property graph, ottobre 2026).
La piattaforma mette a disposizione cinque server Model Context Protocol (MCP) e due prodotti REST, accessibili da un solo profilo e coperti da un unico saldo di token.
Perché CASAFARI è nativa per gli agenti IA
Un responsabile innovazione di una rete immobiliare a Milano necessita di valutare un trilocale in zona Isola. Apri la chat di Claude, inserisce l'URL del server MCP di CASAFARI e autentica la sessione nel browser. Claude interroga direttamente il server Comparables, ottiene la stima del valore e la selezione dei comparabili rilevanti, presentandoli in un prospetto sintetico. Nessun operatore ha dovuto copiare o incollare chiavi segrete all'interno della conversazione.
CASAFARI è progettata fin dalle fondamenta per l'era dell'IA agentica:
- Identità condivisa: il medesimo account serve l'utente umano nella console web e l'agente IA tramite connettori standard.
- Autenticazione trasparente: l'accesso avviene via OAuth nel browser, evitando l'inserimento di credenziali nei prompt.
- Operazioni sicure: 19 dei 21 strumenti MCP documentati operano esclusivamente in sola lettura (fonte: la pagina sulla sicurezza di developers.casafari.com, ottobre 2026).
- Documentazione machine-readable: le specifiche tecniche e i punti d'ingresso per agenti sono pubblicati in formati direttamente leggibili dalle macchine, come illustrato nella guida agli agenti IA (in inglese).
- Consumo di token trasparente: ogni chiamata ad uno strumento richiede un numero fisso di token chiaramente specificato nella sua descrizione.
Per un inquadramento generale sull'integrazione di dati via software, è possibile consultare l'articolo che spiega che cos'è un'API immobiliare. Per approfondire le funzionalità specifiche dell'interfaccia MCP, si veda la pagina prodotto Casafari MCP.
Server MCP disponibili sulla piattaforma
I server MCP di CASAFARI utilizzano lo standard Streamable HTTP e l'autenticazione OAuth 2.1. Ciascun server è dedicato a un ambito applicativo specifico.
Location Lookup
Il server Location Lookup risolve i nomi dei luoghi trasformandoli negli identificativi univoci usati dal property graph (ad esempio Convertendo "Bologna, Bolognina" nel relativo ID di localizzazione). La consultazione di questo strumento è gratuita e rimane priva di costi in token anche dopo il periodo di prova iniziale (URL: https://platform.casafari.com/mcp/locations). Costituisce il punto di partenza per quasi tutti i flussi di lavoro agentici.
Area Insights
Il server Area Insights mette a disposizione 7 strumenti dedicati all'analisi aggregata del mercato: serie storiche dei prezzi, distribuzioni per fasce di prezzo, numero di locali e tempi di permanenza sul mercato, calcoli di CAGR e volatilità, e mappe termiche per quartiere (URL: https://platform.casafari.com/mcp/area-insights).
Un agente IA può utilizzare questi strumenti per mettere a confronto l'andamento del prezzo al metro quadro tra due quartieri di Roma all'interno di un report per un fondo d'investimento. Per l'interfaccia ad uso umano, si veda la pagina dedicata ad Insights dell'Area.
Comparables
Il server Comparables individua gli immobili concorrenti e calcola una stima di valore di mercato per qualsiasi abitazione inserita (URL: https://platform.casafari.com/mcp/comparables). Riconosce i valori anomali e restituisce le proprietà più simili per superficie, ubicazione e caratteristiche. Per approfondimenti sui servizi di stima, consulta la pagina sulle valutazioni e studi di mercato CASAFARI.
AgentGraph AI
Il server AgentGraph AI offre 13 strumenti per analizzare le agenzie e gli agenti immobiliari sul mercato tedesco, incrociando profili aziendali verificati, mappe territoriali, schede partner e liste di monitoraggio (URL: https://platform.casafari.com/mcp/agentgraph). Questo server copre esclusivamente la Germania ed è utile per i gruppi italiani che intendono espandersi o cercare partner in quel mercato. I due strumenti di scrittura presenti richiedono sempre la conferma esplicita dell'utente prima dell'esecuzione.
Claro AI
Il server Claro AI analizza i locali commerciali in vendita o in affitto in Spagna e i terreni commerciali in Germania a partire da un brief descrittivo in lingua naturale, integrando dati di Location Intelligence come flussi pedonali, residenti e sociodemografia (URL: https://platform.casafari.com/mcp/claro). Claro AI è presente nella Connectors Directory ufficiale di Claude. Per dettagli sulla copertura e sui parametri di zona, si veda la documentazione di Claro AI e della Location Intelligence (in inglese).
Nelle misurazioni effettuate il 16 ottobre 2026 e documentate negli esempi reali di Claro AI con Claude (in inglese), un brief per una caffetteria specialty a Valencia (40-120 m², sotto i 3.500 €/mese) ha analizzato 546 locali trovati, permettendo a Claude di selezionare le sei sedi più idonee; una ricerca per una catena di palestre tra le aree metropolitane di Madrid e Barcellona ha vagliato 483 candidati riducendoli a sette schede approfondite; una selezione di terreni commerciali in Germania ha analizzato 1.279 lotti urbanizzati per estrarre i sei lotti ideali per un centro di revisione veicoli.
Si precisa che Claro AI non copre attualmente l'Italia; per la ricerca di immobili sul territorio italiano rimangono attivi i prodotti REST e i server di analisi d'area.
Prodotti REST disponibili sullo stesso account
Oltre ai server MCP, lo stesso account dà accesso immediato alle CASAFARI Property Data APIs in modalità REST. L'autenticazione REST utilizza una chiave API (nel formato cf_sk_…) trasmessa nell'header Authorization: Bearer:
- Property Sourcing: consente la ricerca diretta all'interno del property graph, la risoluzione dei link dai portali immobiliari e la consultazione della storia dei prezzi di ciascun immobile. Maggiori dettagli sulla pagina relativa alla Ricerca di Immobili.
- High Potential Seller Leads: individua le proprietà che hanno subito ripetute riduzioni del prezzo richiesto attorno a un determinato punto di valore. Il servizio restituisce esclusivamente dati dell'immobile e non contiene nomi, numeri di telefono o indirizzi email personali.
Come si crea l'account e come funzionano i token
La registrazione si effettua direttamente online sulla console di platform.casafari.com senza inserire carte di credito. Il piano Free assegna 1.000 token per i primi 30 giorni. Alla scadenza del periodo di prova o al completamento dei token gratuiti, è possibile passare al piano Agent o richiedere un piano Custom per volumi aziendali.
Un unico saldo copre la consultazione di tutti i prodotti REST e MCP. Ogni chiamata ad uno strumento detrae dal saldo un numero fisso di token, indicato nella documentazione tecnica. Quando i token nel saldo si esauriscono, le chiamate vengono interrotte: soltanto un utente umano può acquistare ulteriori token o modificare il piano dalla console. L'agente IA non ha la capacità di effettuare pagamenti o predisporre acquisti autonomi.
Per conoscere i dettagli sui pacchetti e la struttura dei costi, è possibile consultare la FAQ sui piani e i prezzi (in inglese).
Come si collega un agente IA: Claude, ChatGPT, Claude Code, Gemini CLI, Cursor e VS Code
L'integrazione di un server MCP richiede pochi passaggi a seconda del client utilizzato:
- Claude (claude.ai, Claude Desktop, mobile): accedere a Personalizza (Customize) → Connettori (Connectors) → Aggiungi connettore personalizzato, inserire l'URL del server (es.
https://platform.casafari.com/mcp/comparables) ed effettuare l'accesso OAuth nel browser. - ChatGPT: attivare la modalità sviluppatore nelle impostazioni, creare un nuovo connettore inserendo l'URL MCP e confermare l'autenticazione OAuth.
- Claude Code: eseguire da terminale il comando
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparablesoppure installare il plugin disponibile sul repository casafari-mcp su GitHub. - Gemini CLI: digitare
gemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparablese completare con/mcp auth.
I server sono compatibili con qualsiasi client MCP compliant, inclusi Cursor, VS Code, Codex CLI, Zed, Cline, JetBrains Junie, Kiro, Warp e goose. CASAFARI è presente nella Cursor Directory ed è registrata nel registro ufficiale MCP come com.casafari. Per la guida passo passo completa, consultare la guida di connessione su developers.casafari.com (in inglese).
Sicurezza e gestione degli accessi
La piattaforma applica il protocollo OAuth 2.1 con PKCE (Proof Key for Code Exchange) e registrazione dinamica del client. L'applicazione client o l'agente IA non gestiscono mai la password dell'utente. Gli access token hanno una durata limitata a 15 minuti e sono vincolati a uno specifico server (RFC 8707). I refresh token ruotano ad ogni utilizzo.
Per gli agenti che operano in modalità automatizzata non presidiata, la console consente la creazione di client confidenziali o chiavi API gestite da persone fisiche. Ad ogni chiamata, il server verifica i permessi attivi, lo stato del piano e la disponibilità di token. Le chiavi viaggiano esclusivamente nell'header Authorization e mai all'interno degli URL.
Inoltre, l'infrastruttura tratta l'output degli strumenti come dati strutturati e non come istruzioni di sistema, proteggendo il flusso operativo da tentativi di prompt injection.
Un esempio pratico di adozione di strumenti avanzati è descritto nel caso di studio che illustra come Porta da Frente Christie's usa l'IA agentica con i dati CASAFARI.
Configurazione e integrazione nei sistemi aziendali
I team di sviluppo e gli integratori possono accedere alle risorse di configurazione e alla documentazione tecnica OpenAPI direttamente online:
- Punti di ingresso machine-readable: llms.txt di developers e llms.txt di platform.
- Specifica OpenAPI v1:
https://platform.casafari.com/v1/openapi.json. - Guida all'autenticazione agentica:
https://platform.casafari.com/auth.md.
Per esplorare gli scenari d'uso nello sviluppo di software immobiliare, è possibile consultare i casi d'uso per agenti IA sulla documentazione sviluppatori (in inglese). Le organizzazioni con esigenze di volume specifiche o contratti aziendali possono richiedere un piano Custom dalla piattaforma (come funzionano i piani, in inglese).
Per iniziare ad analizzare il mercato con il supporto dell'intelligenza artificiale, è possibile creare un account gratuito nella console di platform.casafari.com.
Domande frequenti
Come collego Claude o ChatGPT ai dati immobiliari di CASAFARI?
In Claude basta accedere a Personalizza, selezionare Connettori, aggiungere l'URL del server MCP desiderato (ad esempio per i comparabili) e completare l'accesso con OAuth nel browser. In ChatGPT si attiva la modalità sviluppatore e si crea un connettore con l'URL del server e l'autenticazione OAuth. Non occorre copiare o incollare chiavi segrete nelle conversazioni (fonte: developers.casafari.com, ottobre 2026).
Che cos'è un server MCP e a cosa serve nel settore immobiliare?
Un server Model Context Protocol (MCP) è un componente standard che consente agli agenti IA di accedere a dati e strumenti esterni in modo sicuro. Nel settore immobiliare permette a modelli come Claude o ChatGPT di interrogare direttamente indici di mercato, stime di prezzo e analisi territoriali. L'accesso avviene con strumenti quasi tutti in sola lettura e autenticazione controllata dall'utente.
CASAFARI copre il mercato immobiliare italiano?
Sì, il property graph di CASAFARI copre 16 paesi (Stati Uniti: ingresso in corso, Stati selezionati, solo immobili commerciali, con Claro AI), Italia compresa, tracciando immobili residenziali e commerciali in vendita e in affitto con la cronologia dei prezzi. Per l'Italia sono disponibili i server Location Lookup, Area Insights e Comparables, oltre ai servizi REST di Property Sourcing e High Potential Seller Leads. Altri server, come AgentGraph AI o Claro AI, coprono mercati specifici come Germania o Spagna (fonte: developers.casafari.com, ottobre 2026; si veda anche la guida su i paesi coperti dai dati CASAFARI).
Quanto costa usare l'API e i server MCP di CASAFARI con un agente IA?
La piattaforma offre un piano Free con 1.000 token gratuiti per i primi 30 giorni, mentre la consultazione di Location Lookup rimane sempre gratuita. L'uso continuativo prevede il piano Agent o piani Custom su misura. Ogni chiamata agli strumenti consuma un numero fisso di token indicato nella documentazione tecnica (fonte: developers.casafari.com, ottobre 2026).
Un agente IA può spendere denaro o modificare dati sul mio account CASAFARI?
No, un agente IA non può effettuare pagamenti né acquistare token in autonomia. Quando il saldo di token si esaurisce, la ricarica o il cambio di piano possono essere effettuati esclusivamente da un utente umano nella console. Inoltre, 19 dei 21 strumenti MCP documentati sono in sola lettura e non consentono la modifica dei dati (fonte: developers.casafari.com, ottobre 2026).
Usare un agente IA con i dati CASAFARI è compatibile con GDPR, AI Act e Legge 132/2025?
La piattaforma fornisce funzionalità tecniche come strumenti quasi tutti in sola lettura, autenticazione OAuth 2.1 e prodotti come High Potential Seller Leads che restituiscono solo dati dell'immobile senza nomi, numeri di telefono o indirizzi email personali. Il contatto con i clienti viene svolto direttamente da un operatore umano. La valutazione sulla conformità legale dell'intero flusso di lavoro rimane sotto la responsabilità dell'utente o del titolare del trattamento.