ImmobilienScout24 mit Claude verbinden (MCP)

ImmobilienScout24 mit Claude verbinden

ImmobilienScout24 ist Deutschlands größtes Immobilienportal. Mit AnythingMCP durchsucht Claude die Inserate über die offizielle ImmobilienScout24 REST API: Du beschreibst, was du suchst, Claude ermittelt den Gebietscode, startet die Suche und liest die Exposés für dich.

Der Connector hat drei lesende Tools für die öffentliche Inseratssuche. Deine eigenen Inserate oder Anfragen verwaltet er nicht (mehr dazu in den FAQ unten).

Was du Claude fragen kannst

• "Finde 2-Zimmer-Mietwohnungen in Berlin Mitte für höchstens 1.200 € im Monat." Nutzt is24_search_locations für den GeoCode von Berlin Mitte, dann is24_search_properties mit Typ apartmentrent, price_max 1200 und numberofrooms_min 2.
• "Wie lautet der GeoCode für Hamburg Altona?" Nutzt is24_search_locations.
• "Häuser zum Kauf in Freiburg mit mindestens 120 m² Wohnfläche, bis 750.000 €." Nutzt is24_search_locations, dann is24_search_properties mit Typ housebuy, livingspace_min und price_max.
• "Zeig mir Exposé 123456789 komplett: Beschreibung, Ausstattung, Energieausweis, Kontakt." Nutzt is24_get_property.
• "Büroflächen zur Miete in München Schwabing, zeig mir die zweite Ergebnisseite." Nutzt is24_search_properties mit Typ office und pagenumber 2.
• "Sortiere diese Ergebnisse und nenn mir die fünf günstigsten pro Quadratmeter." Das rechnet Claude aus den Suchergebnissen, die es schon hat.

Was du brauchst

• Ein ImmobilienScout24-Geschäftskonto. ImmobilienScout24 gibt API-Zugang nur an Geschäftskonten; private Konten bekommen ihn nicht.
• Einen API-Schlüsselsatz aus dem IS24 Self-Service-Portal. Der Key kommt in IS24_CONSUMER_KEY, das Secret in IS24_CONSUMER_SECRET.
• Die passende Umgebung. Du kannst Schlüssel für die Sandbox erzeugen (kostenlos, zum Testen, mit anonymisierten Testdaten) und für Produktion (echte Inserate). Der Connector ruft standardmäßig die Produktions-API auf.
• Für Produktion: Du akzeptierst die API-Nutzungsbedingungen, die Nutzung wird nach der Preisliste von ImmobilienScout24 abgerechnet, und manche Anwendungsfälle brauchen vorher eine Partnerfreigabe, die nicht sofort erteilt wird.

ImmobilienScout24 nutzt weiterhin OAuth 1.0a, bei dem jede Anfrage signiert werden muss. AnythingMCP signiert jeden Aufruf mit deinem Schlüsselpaar (zweibeinig, nur App-Kontext), du musst also kein Token tauschen oder erneuern.

Schritt 1 — IS24-Zugangsdaten holen

1. Öffne das IS24 Self-Service-Portal.
2. Melde dich mit einem ImmobilienScout24-Geschäftskonto an oder lege eines an.
3. Erzeuge einen API-Schlüsselsatz: Sandbox zum Testen und/oder Produktion für echte Daten.
4. Kopiere API-Key und Secret.

Schritt 2 — Connector installieren

Auf AnythingMCP Cloud öffnest du Connectors, wählst ImmobilienScout24 API und fügst den Key in IS24_CONSUMER_KEY und das Secret in IS24_CONSUMER_SECRET ein.

Wenn du lieber selbst hostest, startest du AnythingMCP mit Docker und installierst den Connector unter http://localhost:3000/connectors/store:

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — In Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Auf claude.ai (danach ist der Connector auch in Claude Desktop verfügbar):

1. Öffne claude.ai/customize/connectors.
2. Klicke auf + und dann auf "Add custom connector".
3. Gib als Namen AnythingMCP und als URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
4. Klicke auf "Add" und dann auf "Connect". Melde dich bei AnythingMCP an und wähle, welche deiner MCP-Server Claude nutzen darf.

In Claude Code führst du den folgenden Befehl aus, tippst dann in einer Sitzung /mcp und wählst Authenticate:

claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID

Du hostest selbst? Dann nimm deine eigene AnythingMCP-URL statt cloud.anythingmcp.com. Für claude.ai muss sie aus dem Internet erreichbar sein, weil Claude sich von den Servern von Anthropic aus verbindet, nicht von deinem Rechner.

Verfügbare Tools

Fehlerbehebung

• Jeder Aufruf wird sofort abgelehnt. Sandbox-Schlüssel funktionieren nur in der Sandbox, und der Connector ruft die Produktions-API auf. Nimm Produktionsschlüssel oder stell die Basis-URL des Connectors zum Testen auf https://rest.sandbox-immobilienscout24.de/restapi/api um. Prüf auch, ob Key und Secret vertauscht sind: Die Signatur wird aus beiden gebildet.
• Produktionsschlüssel sind da, trotzdem werden Aufrufe abgelehnt. Manche Anwendungsfälle brauchen eine Partnerfreigabe, bevor ImmobilienScout24 den Produktionszugang öffnet. Prüf den Status deines Schlüsselsatzes im Self-Service-Portal.
• Die Suche findet nichts oder den falschen Ort. is24_search_properties braucht einen GeoCode, keinen Ortsnamen. Lass Claude den Ort zuerst mit is24_search_locations auflösen und wähle den richtigen Eintrag, wenn mehrere Orte gleich heißen.
• Zu viele Anfragen auf einmal. ImmobilienScout24 begrenzt, wie oft ein Schlüssel die API aufrufen darf (siehe Rate Limiting im Entwicklerportal). Frag nach weniger Ergebnisseiten auf einmal.

FAQ

Kann Claude meine eigenen Inserate oder Anfragen auf ImmobilienScout24 verwalten? Nein. Der Connector signiert Anfragen nur im App-Kontext (zweibeinig), das deckt die öffentliche Inseratssuche und Exposé-Abfragen ab. Für deine eigenen Objekte oder Anfragen braucht es Zugriff im Nutzerkontext, den dieser Connector nicht anbietet.

Funktioniert das in Claude Desktop und Claude Code? Ja. Ein Custom Connector, den du auf claude.ai hinzufügst, steht auch in Claude Desktop zur Verfügung, und in Claude Code fügst du dieselbe URL mit claude mcp add --transport http hinzu. Custom Connectors gibt es in jedem Claude-Tarif; im Free-Tarif ist einer erlaubt, und das reicht, weil ein einziger AnythingMCP-Connector alle deine Connectoren mitbringt.

Ist das kostenlos? AnythingMCP ist Open Source unter AGPL-3.0: Self-Hosting ist kostenlos, auch für die kommerzielle Nutzung in deinem eigenen Unternehmen. AnythingMCP Cloud kannst du 7 Tage kostenlos testen. Bei ImmobilienScout24 sind Sandbox-Schlüssel kostenlos, die Produktionsnutzung wird nach der Preisliste von ImmobilienScout24 abgerechnet.

Speichert AnythingMCP meine Daten? Dein IS24-Key und das Secret liegen verschlüsselt (AES-256-GCM) in deinem Workspace und werden Claude nie gezeigt. Wenn Claude ein Tool nutzt, ruft AnythingMCP ImmobilienScout24 auf und gibt das Ergebnis an Claude weiter; der Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet.

Nächste Schritte

• ImmobilienScout24-MCP-Server für andere KI-Clients
• ImmobilienScout24 mit ChatGPT verbinden
• ImmobilienScout24 mit Cursor verbinden
• ImmobilienScout24 mit Gemini verbinden
• ImmobilienScout24 mit Meta Muse verbinden