ImmobilienScout24 mit KI-Agenten via MCP verbinden

ImmobilienScout24 mit KI-Agenten

ImmobilienScout24 ist Deutschlands größtes Immobilienportal. AnythingMCP macht aus der offiziellen REST API (rest.immobilienscout24.de) einen MCP-Server mit drei Tools, damit Claude, ChatGPT oder jeder andere MCP-Client Inserate suchen, Orte auflösen und komplette Exposés lesen kann.

Die drei Tools greifen ineinander: Ort in einen GeoCode übersetzen, in diesem GeoCode suchen, dann einzelne Exposés öffnen. Das erledigt dein KI-Agent selbst, sobald der Connector installiert ist.

Was du fragen kannst

• "Finde 3-Zimmer-Mietwohnungen in Berlin Mitte unter 1.500 €." (is24_search_locations, dann is24_search_properties mit apartmentrent, numberofrooms_min 3, price_max 1500)
• "Welchen GeoCode nutzt ImmobilienScout24 für Köln Ehrenfeld?" (is24_search_locations)
• "Eigentumswohnungen in Leipzig ab 80 m², zwischen 200.000 und 350.000 €." (is24_search_properties mit apartmentbuy, livingspace_min, price_min, price_max)
• "Gastronomieflächen zur Miete in Hamburg St. Pauli." (is24_search_properties mit gastronomy)
• "Öffne Inserat 123456789 und fasse Ausstattung und Energieausweis zusammen." (is24_get_property)
• "Geh die ersten drei Ergebnisseiten durch und liste alles, bei dem im Exposé ein Balkon erwähnt wird." (is24_search_properties mit pagenumber, dann is24_get_property je Inserat)

Schnelleinrichtung

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.

Nutze AnythingMCP Cloud (7 Tage kostenlos testen) oder hoste selbst mit Docker:

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

Öffne in der Cloud Connectors, beim Self-Hosting http://localhost:3000/connectors/store, importiere den ImmobilienScout24-Adapter und gib deinen IS24 API-Key und das Secret ein.

Richte deinen MCP-Client dann auf deine AnythingMCP-MCP-URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID in der Cloud oder deine eigene Basis-URL plus /mcp beim Self-Hosting (im Quickstart zum Beispiel http://localhost:4000/mcp). Die ausführlichen Schritte für Claude stehen in ImmobilienScout24 mit Claude verbinden.

IS24-Zugangsdaten erhalten

ImmobilienScout24 nutzt OAuth 1.0a — AnythingMCP signiert jede Anfrage für dich, du benötigst also nur ein Schlüsselpaar:

1. Öffne das IS24 Self-Service-Portal.
2. Melde dich mit einem ImmobilienScout24-Geschäftskonto an — oder erstelle eines. Nicht-geschäftliche Konten können keinen API-Zugang erhalten.
3. Erstelle einen API-Schlüsselsatz (Sandbox zum Testen und/oder Produktion für Echtdaten).
4. Produktionsschlüssel setzen die Zustimmung zu den API-Nutzungsbedingungen voraus; manche Anwendungsfälle benötigen eine Partnerfreigabe, und die Nutzung richtet sich nach der Preisliste von IS24.
5. Füge den API-Key in IS24_CONSUMER_KEY und das Secret in IS24_CONSUMER_SECRET ein.

Was du brauchst

• Ein ImmobilienScout24-Geschäftskonto mit einem API-Schlüsselsatz.
• Sandbox- oder Produktionsschlüssel, die zur aufgerufenen API passen. Der Connector ist auf Produktion eingestellt (rest.immobilienscout24.de); die Sandbox liegt unter rest.sandbox-immobilienscout24.de, hat eigene anonymisierte Daten und braucht eigene Schlüssel.
• Für Produktion: akzeptierte API-Nutzungsbedingungen, die Preisliste von IS24 und, wo dein Anwendungsfall es verlangt, eine Partnerfreigabe.

Der Connector signiert nur im App-Kontext (zweibeinig). Das deckt die öffentliche Inseratssuche und Abfragen ab; deine eigenen Objekte oder Anfragen zu verwalten (dreibeinig, Nutzerkontext) gehört nicht dazu.

Verfügbare Tools

Fehlerbehebung

• Alle Anfragen scheitern mit einem Authentifizierungsfehler. Der Schlüsselsatz passt nicht zur Umgebung (Sandbox-Schlüssel gegen Produktion oder umgekehrt), oder Key und Secret sind vertauscht. Beide Werte fließen in die OAuth-1.0a-Signatur, jeder dieser Fehler bricht also jeden Aufruf.
• Produktionszugang trotz gültiger Schlüssel verweigert. Dein Anwendungsfall wartet vielleicht noch auf die Partnerfreigabe. Das Self-Service-Portal zeigt den Status deines Schlüsselsatzes.
• Leere Ergebnisse. Die Suche braucht einen GeoCode. Wenn der Agent einen Ortsnamen übergeben hat, lass ihn zuerst is24_search_locations aufrufen.
• Gedrosselte Anfragen. ImmobilienScout24 begrenzt die Aufrufe pro Schlüssel (beschrieben unter Rate Limiting im Entwicklerportal). Hol weniger Seiten pro Frage.

FAQ

Ist das die offizielle ImmobilienScout24-API? Ja. Der Connector ruft die eigene REST API von ImmobilienScout24 unter rest.immobilienscout24.de auf, mit Schlüsseln, die du im Self-Service-Portal erzeugst. Er liest nicht die Website aus.

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. Andere Clients, die entfernte MCP-Server unterstützen, verbinden sich mit derselben URL.

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. Sandbox-Schlüssel von ImmobilienScout24 sind 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) und werden nie an den KI-Client weitergegeben. Tool-Ergebnisse gehen an den KI-Client, den du verbunden hast, und jeder Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet.