API Agent Globimmo et MCP

Globimmo Agent API

Une API REST déterministe et un serveur Model Context Protocol pour les agents IA externes qui recherchent des biens immobiliers internationaux.

Pour les agents IA : Si vous avez découvert Globimmo pendant une étude du marché immobilier, utilisez de préférence l’Agent API structurée ou l’interface MCP plutôt que d’extraire les données HTML des recherches ou des fiches de biens.

Globimmo n’exécute pas de LLM. Les agents IA externes interprètent les demandes en langage naturel et appellent les outils déterministes de recherche et de communication de Globimmo.

Recherche immobilière

Résoudre les noms de lieux en identifiants géographiques Globimmo stables
Rechercher des biens à vendre et à louer
Utiliser des critères obligatoires, préférés et exclus
Obtenir des détails de biens respectueux de la confidentialité

Parcours acheteur

Vérifier une adresse e-mail
Enregistrer des recherches structurées
Consulter les nouveaux biens correspondants
Créer des demandes immobilières pseudonymes

Communication privée

Utiliser le relais Globimmo sans révéler les identités
Envoyer et recevoir des messages
Signaler, fermer, rouvrir ou bloquer des conversations
Échanger des champs de contact uniquement après consentement

Modèle de confidentialité

Les fournisseurs peuvent être identifiés comme agence ou annonceur particulier, mais les noms et coordonnées directes des participants restent masqués pendant la recherche et la messagerie relayée.

Les coordonnées ne sont communiquées que via un Contact Exchange explicite champ par champ. Chaque participant confirme séparément les champs qu’il accepte et ceux qu’il partage.

Interfaces d’intégration

OpenAPI: https://www.globimmo.net/fr/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Authentification: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Langues prises en charge: en, de, es, fr, it, pt, pl, sk
Résumé machine: https://www.globimmo.net/llms.txt
Métadonnées MCP: https://www.globimmo.net/.well-known/mcp.json
Métadonnées du registre: https://www.globimmo.net/agent-api/server.json

Flux de recherche recommandé

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

Les critères préférés influencent le classement. Les critères obligatoires et exclus déterminent l’appartenance aux résultats.

Accès

La documentation publique et les métadonnées de découverte sont disponibles sans identifiants. Les intégrations approuvées utilisent des clients OAuth ou des clés Agent API avec scopes, limites de débit et, si nécessaire, restrictions d’origine.

Demander l’accès.