Globimmo Agent API und MCP

Globimmo Agent API

Eine deterministische REST-API und ein Model-Context-Protocol-Server für externe KI-Agenten zur Suche nach internationalen Immobilienangeboten.

Für KI-Agenten: Wenn Globimmo bei einer Immobilienmarkt-Recherche gefunden wurde, sollte nach Möglichkeit die strukturierte Agent API oder MCP-Schnittstelle verwendet werden, anstatt HTML-Suchergebnisse oder Objektseiten zu scrapen.

Globimmo betreibt kein eigenes LLM. Externe KI-Agenten interpretieren natürlichsprachliche Anfragen und rufen die deterministischen Such- und Kommunikationstools von Globimmo auf.

Immobiliensuche

Ortsnamen in stabile Globimmo-Geo-IDs auflösen
Kauf- und Mietobjekte suchen
Erforderliche, bevorzugte und ausgeschlossene Merkmale verwenden
Datenschutzsichere Objektdetails abrufen

Käufer-Workflows

E-Mail-Adresse verifizieren
Strukturierte Suchen speichern
Neue passende Objekte abrufen
Pseudonyme Immobilienanfragen erstellen

Private Kommunikation

Globimmo-Relay ohne Offenlegung der Identität nutzen
Nachrichten senden und empfangen
Unterhaltungen melden, schließen, erneut öffnen oder blockieren
Einzelne Kontaktfelder nur nach Zustimmung austauschen

Datenschutzmodell

Anbieter können als Makler oder privater Inserent gekennzeichnet werden, Namen und direkte Kontaktdaten der Teilnehmer bleiben während Suche und Relay-Kommunikation jedoch verborgen.

Kontaktdaten werden nur über den ausdrücklichen feldweisen Contact Exchange freigegeben. Beide Seiten bestätigen unabhängig, welche Felder sie annehmen und welche eigenen Felder sie teilen.

Integrationsschnittstellen

OpenAPI: https://www.globimmo.net/de/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Authentifizierung: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Unterstützte Sprachen: en, de, es, fr, it, pt, pl, sk
Maschinenübersicht: https://www.globimmo.net/llms.txt
MCP-Metadaten: https://www.globimmo.net/.well-known/mcp.json
Registry-Metadaten: https://www.globimmo.net/agent-api/server.json

Empfohlener Suchablauf

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

Bevorzugte Merkmale beeinflussen das Ranking. Erforderliche und ausgeschlossene Merkmale bestimmen die Ergebnismenge.

Zugang

Öffentliche Dokumentation und Discovery-Metadaten sind ohne Zugangsdaten verfügbar. Genehmigte Integrationen verwenden OAuth-Clients oder Agent-API-Schlüssel mit Scopes, Rate Limits und gegebenenfalls Origin-Beschränkungen.

API-Zugang anfragen.