Location Lookup per MCP und REST: Ortsnamen in Casafari location_id auflösen
Location Lookup ist das kostenlose Ortsverzeichnis von CASAFARI, das Städtenamen, Stadtteile, Bezirke und Postleitzahlen in eine eindeutige location_id umwandelt. Area Insights und Property Sourcing benötigen diese ID als Eingabe; Comparables und Seller Leads arbeiten mit Koordinaten oder Adressen, AgentGraph und Claro mit Ortsnamen. Über das Tool locations_search am MCP-Server https://platform.casafari.com/mcp/locations oder per REST API schlägt die Auflösung mit 0 Tokens zu Buche. Für KI-Agenten und Anwendungen gilt daher stets: erst den Ort auflösen, dann Immobiliendaten abfragen.
Was ist Location Lookup, und warum steht es am Anfang jeder Abfrage?
Location Lookup fungiert als spezialisiertes Wörterbuch für Standorte. Es übersetzt menschenlesbare Ortsnamen, Verwaltungseinheiten und Postleitzahlen in die strukturierte location_id, die das Datenfundament von CASAFARI steuert. Bitte verwechseln Sie Location Lookup nicht mit der Location Intelligence von Targomo, die auf Footfall, Einzugsgebiete und Erreichbarkeitsanalysen spezialisiert ist.
Der immobilienbezogene Property Graph von CASAFARI deckt Wohn- und Gewerbeimmobilien in 16 Ländern (USA: Markteintritt läuft, ausgewählte Bundesstaaten, nur Gewerbeimmobilien, über Claro AI) ab (Stand Oktober 2026, siehe Entwicklerdokumentation zum Property Graph auf Englisch). Jedes Objekt ist darin einem eindeutigen Knotenpunkt in einer geografischen Hierarchie zugeordnet. Wenn eine Anfrage ohne eindeutige Kennung gestellt wird, entsteht Unschärfe.
Fragt ein Nutzer in Claude beispielsweise nach den durchschnittlichen Angebotspreisen in „Mitte“, lässt sich ohne vorherige Ortsauflösung nicht feststellen, ob der Bezirk Berlin-Mitte, Hamburg-Mitte oder der Stadtteil Mitte in Bremen gemeint ist. Ein systematischer Workflow gliedert sich deshalb immer in vier aufeinanderfolgende Schritte:
Warum ein Ortsname allein nicht reicht: 27 Mal Neustadt und rund 10.750 Gemeinden
In Deutschland existieren laut dem Gemeindeverzeichnis des Statistischen Bundesamts rund 10.750 Gemeinden (Stand 2024). Viele dieser Gemeinden tragen identische oder verwechselbar ähnliche Namen. Die Arbeitsgemeinschaft Neustadt in Europa zählt allein in Deutschland 27 Städte und Gemeinden, die den Namen „Neustadt“ tragen.
Ähnliche Mehrdeutigkeiten treten bei Frankfurt am Main und Frankfurt (Oder) auf sowie bei Bezeichnungen wie „Altstadt“ oder „Nord“, die in Dutzenden deutschen Kommunen vorkommen. Auch Postleitzahlen sind nicht immer deckungsgleich mit Gemeindegrenzen, da sie mehrere Ortsteile umfassen können.
In Österreich und der Schweiz setzt sich dieses Muster fort: Ein Wiener Bezirk wie 1070 Neubau oder Zürcher Quartiere erfordern ebenso eine präzise geografische Zuordnung. Verarbeitet ein KI-Agent reinen Freitext, muss er raten. Arbeitet er hingegen mit der festen location_id, werden Analyseergebnisse reproduzierbar, transparent und verlässlich.
So rufen Sie locations_search über MCP auf
Für die Anbindung über das Model Context Protocol steht ein eigener MCP-Server bereit. Der Endpunkt für Standortabfragen lautet https://platform.casafari.com/mcp/locations. CASAFARI stellt für jedes Themenfeld einen eigenen MCP-Server bereit (darunter locations, area-insights, comparables, agentgraph und claro).
Als Protokoll-Transport dient Streamable HTTP laut MCP-Spezifikation (Stand Juli 2026). Die Authentifizierung erfolgt direkt im Browser per OAuth 2.1, ohne dass API-Schlüssel manuell kopiert werden müssen. Beim ersten Login lässt sich direkt ein kostenfreies Konto erstellen (Stand Oktober 2026, siehe Anleitung zum Verbinden der Casafari-MCP-Server auf Englisch). Mehr Details zur Integration finden Sie auf unserer Produktseite für CASAFARI MCP – Immobiliendaten für KI-Agenten.
Der Server unterstützt alle gängigen MCP-Clients wie Claude (Desktop, Web und mobil), ChatGPT im Developer Mode, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Devin Desktop, Visual Studio, Zed, Cline, JetBrains Junie, Kiro, Warp oder goose. Ein Claude-Code-Plugin mit Skills, eine Gemini-CLI-Erweiterung und Codebeispiele finden Sie im öffentlichen GitHub-Repository casafari/casafari-mcp (auf Englisch). Eine Anfrage an das Tool locations_search lässt sich beispielsweise wie folgt formulieren:
„Löse Neustadt an der Weinstraße auf und gib mir die location_id.“
Als Antwort liefert der Server die eindeutige ID, den offiziellen Namen, die administrative Ebene (z. B. Stadt, Bezirk oder PLZ) sowie den übergeordneten Ort zur Kontrolle zurück. Mit dieser location_id kann der Agent direkt im Anschluss Marktanalysen über Area Insights anfordern.
Location Lookup über REST: derselbe Dienst für Ihre eigene Anwendung
Wenn Sie eigene Softwareanwendungen, Portale oder interne Dashboards entwickeln, steht Location Lookup als klassischer REST-Endpunkt zur Verfügung. Zugangsschlüssel und Kontoverwaltung finden Sie direkt, indem Sie ein Konto auf platform.casafari.com anlegen.
Der Endpunkt lautet GET https://platform.casafari.com/v1/locations/search; Informationen dazu bietet die Beschreibung von Location Lookup auf developers.casafari.com (auf Englisch). Wenn Sie grundlegende Informationen zur Einbindung suchen, hilft unser Beitrag darüber, was eine API-Plattform ist.
Für die Softwarearchitektur empfiehlt sich folgendes Vorgehen: Speichern Sie die aufgelösten Zuordnungen (Ortsname/PLZ → location_id) in einer lokalen Mapping-Tabelle Ihrer Datenbank. Obwohl der Abruf kostenfrei ist, reduzieren Sie dadurch Netzwerklatenzen in Ihrer Anwendung. Eine Übersicht über die passenden Entwicklerwerkzeuge finden Sie bei den Property Data APIs von CASAFARI.
Was Location Lookup kostet: 0 Tokens, in jedem Plan
Die Abfrage von Standort-IDs über Location Lookup belastet Ihr Token-Guthaben nicht. Jede Ortsauflösung kostet genau 0 Tokens – unabhängig davon, welchen Tarif Sie nutzen (Stand Oktober 2026, siehe Pläne und Token-Preise in der Entwickler-FAQ auf Englisch).
Folgende Tarifstrukturen stehen zur Auswahl:
- Free-Plan: 0 € im Monat, enthält 1.000 Tokens für 30 Tage, keine Kreditkarte erforderlich.
- Agent-Plan: 49 € pro Monat bei jährlicher Zahlungsweise oder 70 € bei monatlicher Abrechnung (jeweils zzgl. MwSt.).
- Custom-Plan: Individuelle Volumenvereinbarungen per Vertrag.
- Zusatzverbrauch: Flexibel über vorausbezahlte Credits steuerbar.
Die kostenfreie Bereitstellung stellt sicher, dass alle nachgelagerten Markt- und Objektanalysen auf einer sauberen geografischen Datenbasis aufbauen.
Drei Regeln für Agenten: erst auflösen, dann abfragen
Damit KI-Agenten zuverlässig arbeiten, sollten Sie in Prompts und Systemanweisungen drei klare Grundregeln verankern:
- Kein Freitext in Datenabfragen: Übergeben Sie Ortsnamen nie direkt an Area Insights oder Property Sourcing. Verwenden Sie dort ausnahmslos die ermittelte
location_id. - Mehrfachtreffer prüfen: Liefert die Suchanfrage mehrere Ergebnisse (wie im Beispiel Neustadt), soll der Agent beim Nutzer nachfragen oder das Ergebnis über das Bundesland bzw. den Landkreis eingrenzen.
- Administrative Ebene nennen: Eine Postleitzahl, ein Stadtteil und eine gesamte Kommune liefern unterschiedlich aggregierte Kennzahlen. Der Agent sollte der Nutzerin oder dem Nutzer stets mitteilen, auf welcher Ebene die Analyse erfolgt.
Beachten Sie bei der Abfrage von Gewerbeimmobilien über Claro die spezifische Abdeckung: Commercial Premises stehen für Deutschland und Spanien zur Verfügung, während Commercial Plots derzeit exklusiv in Deutschland erfasst sind (Stand Oktober 2026). Claro nimmt dabei Städte, Provinzen und Bundesländer direkt beim Namen entgegen.
Verbinden Sie jetzt den MCP-Server unter https://platform.casafari.com/mcp/locations mit Ihrem Client, lösen Sie Ihren ersten Zielort auf und fragen Sie im Anschluss die aktuellen Marktdaten über Area Insights ab.
Häufig gestellte Fragen
Was ist Location Lookup bei Casafari?
Location Lookup ist das kostenlose Standortverzeichnis von CASAFARI, das Ortsnamen, Stadtteile, Bezirke und Postleitzahlen in eine eindeutige location_id umwandelt. Diese ID dient als notwendige Eingabe für Area Insights und Property Sourcing. Der Dienst steht sowohl über das Model Context Protocol (MCP) mit dem Tool locations_search als auch über eine REST API zur Verfügung.
Wie verbinde ich Claude oder ChatGPT mit dem Casafari MCP-Server?
Tragen Sie die Server-URL https://platform.casafari.com/mcp/locations als Custom Connector in Claude (Web, Desktop oder mobil) oder ChatGPT (Developer Mode) ein. Die Authentifizierung erfolgt per OAuth 2.1 direkt im Browser, sodass keine API-Schlüssel manuell kopiert werden müssen. Beim ersten Anmelden lässt sich direkt ein kostenfreies Konto im Free-Plan ohne Kreditkarte anlegen (Stand Oktober 2026, CASAFARI developer docs – Connect). Auch andere MCP-Clients wie Cursor, VS Code oder Claude Code lassen sich auf diese Weise verbinden.
Was kostet eine Ortsabfrage über MCP?
Abfragen über Location Lookup kosten in jedem Tarif genau 0 Tokens. Der Einstieg ist über den Free-Plan möglich, der 1.000 Tokens für 30 Tage ohne Angabe einer Kreditkarte bereitstellt. Für eine intensivere Nutzung steht der Agent-Plan für 49 € pro Monat bei jährlicher Abrechnung oder 70 € bei monatlicher Zahlungsweise zur Verfügung (jeweils zzgl. MwSt., Stand Oktober 2026, CASAFARI developer docs – FAQ).
Warum braucht ein KI-Agent eine location_id, bevor er Immobiliendaten abfragt?
Ortsnamen sind in der Praxis häufig mehrdeutig: In Deutschland heißen laut der Arbeitsgemeinschaft Neustadt in Europa 27 Orte Neustadt, und das Gemeindeverzeichnis von Destatis verzeichnet rund 10.750 Gemeinden (Stand 2024). Wenn ein KI-Agent rein nach Freitext sucht, muss er das Zielgebiet raten. Die vorherige Auflösung in eine location_id garantiert dagegen präzise, nachvollziehbare und reproduzierbare Abfragen.
Funktioniert Location Lookup auch mit Postleitzahlen und Stadtteilen?
Ja, Location Lookup verarbeitet Städte, Stadtteile, Bezirke und Postleitzahlen gleichermaßen und ordnet ihnen jeweils eine spezifische Ebene in der Ortshierarchie zu. Da Postleitzahlen mehrere Ortsteile umfassen können und Namen wie „Mitte“ in verschiedenen Städten vorkommen, sollte das Ergebnis stets mit dem übergeordneten Ort abgeglichen werden. Falls ein gesuchter Ort einmal nicht direkt gefunden wird, erklärt unser Leitfaden, was zu tun ist, wenn ein Ort nicht gefunden wird.