Globimmo Agent API e MCP

Globimmo Agent API

Un’API REST deterministica e un server Model Context Protocol per agenti IA esterni che cercano annunci immobiliari internazionali.

Per gli agenti IA: Se hai trovato Globimmo durante una ricerca sul mercato immobiliare, usa quando possibile la Agent API strutturata o l’interfaccia MCP invece di estrarre dati dall’HTML delle ricerche o delle schede immobili.

Globimmo non esegue un LLM. Gli agenti IA esterni interpretano le richieste in linguaggio naturale e chiamano gli strumenti deterministici di ricerca e comunicazione di Globimmo.

Ricerca immobili

Risolvere i nomi delle località in identificatori geografici Globimmo stabili
Cercare immobili in vendita e in affitto
Usare caratteristiche obbligatorie, preferite ed escluse
Ottenere dettagli immobiliari sicuri per la privacy

Flussi per acquirenti

Verificare un indirizzo e-mail
Salvare ricerche strutturate
Controllare nuovi immobili corrispondenti
Creare richieste immobiliari pseudonime

Comunicazione privata

Usare il relay Globimmo senza esporre le identità
Inviare e ricevere messaggi
Segnalare, chiudere, riaprire o bloccare conversazioni
Scambiare singoli campi di contatto solo con consenso

Modello di privacy

I fornitori possono essere identificati come agenzia o inserzionista privato, ma nomi e contatti diretti dei partecipanti restano nascosti durante la ricerca e la messaggistica relay.

I dati di contatto vengono rilasciati solo tramite Contact Exchange esplicito a livello di singolo campo. Ogni partecipante conferma separatamente quali campi accetta e quali propri campi condivide.

Interfacce di integrazione

OpenAPI: https://www.globimmo.net/it/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Autenticazione: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Lingue supportate: en, de, es, fr, it, pt, pl, sk
Riepilogo machine-readable: https://www.globimmo.net/llms.txt
Metadati MCP: https://www.globimmo.net/.well-known/mcp.json
Metadati registro: https://www.globimmo.net/agent-api/server.json

Flusso di ricerca consigliato

resolve_location
→ search_properties
→ get_property / select_property
→ verify email when persistence or inquiry is needed
→ save_search / create_inquiry
→ relay messaging
→ Contact Exchange after explicit consent

Le caratteristiche preferite influenzano il ranking. Quelle obbligatorie ed escluse determinano l’appartenenza ai risultati.

Accesso

La documentazione pubblica e i metadati di discovery sono disponibili senza credenziali. Le integrazioni approvate usano client OAuth o chiavi Agent API con scope, limiti di utilizzo e, quando necessario, restrizioni di origine.

Richiedi accesso.