ImmobilienScout24 mit Meta Muse verbinden (MCP)

ImmobilienScout24 mit Muse verbinden

ImmobilienScout24 ist Deutschlands größtes Immobilienportal. Mit AnythingMCP durchsucht Muse die Inserate über die offizielle ImmobilienScout24 REST API: Du beschreibst, was du suchst, Muse 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 Muse 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 Muse 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 Muse 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.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die ImmobilienScout24-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

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 Muse 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 Muse 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.

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 Muse nie gezeigt. Wenn Muse ein Tool nutzt, ruft AnythingMCP ImmobilienScout24 auf und gibt das Ergebnis an Muse weiter; der Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet.

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

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