Airbnb-Suche & Unterkünfte - MCP Bundle (MCPB)

Ein umfassendes MCP-Bundle für die Suche nach Airbnb-Unterkünften mit erweiterten Filterfunktionen und dem Abruf detaillierter Objektinformationen. Entwickelt als Model Context Protocol (MCP)-Server im MCP Bundle (MCPB)-Format für eine einfache Installation und Nutzung mit kompatiblen KI-Anwendungen.

Funktionen

🔍 Erweiterte Suchfunktionen

• Standortbasierte Suche mit Unterstützung für Städte, Bundesländer und Regionen

• Internationale Standortunterstützung durch clientseitiges Geocoding, sodass Nicht-US-Anfragen (z. B. "Paris, Frankreich", "Kopenhagen, Dänemark") Ergebnisse in der richtigen Stadt liefern

• Google Maps Place ID-Integration für präzise Standortbestimmung

• Filterung nach Unterkunftstyp für gesamte Unterkünfte, Privatzimmer, gemeinsam genutzte Zimmer oder Hotelzimmer

• Datumsfilterung mit Unterstützung für Check-in- und Check-out-Daten

• Gästekonfiguration einschließlich Erwachsener, Kinder, Kleinkinder und Haustiere

• Preisspannenfilterung mit Mindest- und Höchstpreisbeschränkungen

• Paginierungsunterstützung zum Durchsuchen großer Ergebnismengen

🏠 Detaillierte Objektinformationen

• Umfassende Listendetails einschließlich Ausstattung, Richtlinien und Highlights

• Standortinformationen mit Koordinaten und Details zur Nachbarschaft

• Hausregeln und Richtlinien für fundierte Buchungsentscheidungen

• Objektbeschreibungen und Hauptmerkmale

• Direktlinks zu Airbnb-Unterkünften für eine einfache Buchung

🛡️ Sicherheit & Compliance

• Robots.txt-Konformität mit konfigurierbarem Override für Testzwecke

• Anfrage-Timeout-Management, um hängende Anfragen zu verhindern

• Erweiterte Fehlerbehandlung mit detaillierter Protokollierung

• Bewusstsein für Ratenbegrenzungen und respektvolle API-Nutzung

• Sichere Konfiguration durch MCPB-Benutzereinstellungen

Related MCP server: brasil-api-mcp-server

Installation

Für Claude Desktop

Diese Erweiterung ist als MCP Bundle (.mcpb)-Datei verpackt. Zur Installation:

1. Laden Sie die .mcpb-Datei aus dem neuesten Release herunter

2. Öffnen Sie die Datei — Claude Desktop zeigt einen Installationsdialog an

3. Konfigurieren Sie die Erweiterungseinstellungen nach Bedarf

Um die robots.txt zu ignorieren, öffnen Sie die Claude Desktop-Einstellungen, navigieren Sie zur Erweiterung und aktivieren Sie den Schalter Ignore robots.txt.

Für Cursor, etc.

Stellen Sie vor dem Start sicher, dass Node.js auf Ihrem Desktop installiert ist, damit npx funktioniert.

1. Gehen Sie zu: Cursor Settings > Tools & Integrations > New MCP Server

2. Fügen Sie eines der folgenden Elemente zu Ihrer mcp.json hinzu:

   {
     "mcpServers": {
       "airbnb": {
         "command": "npx",
         "args": [
           "-y",
           "@openbnb/mcp-server-airbnb"
         ]
       }
     }
   }

   Um die robots.txt für alle Anfragen zu ignorieren, verwenden Sie diese Version mit --ignore-robots-txt Argumenten

   {
     "mcpServers": {
       "airbnb": {
         "command": "npx",
         "args": [
           "-y",
           "@openbnb/mcp-server-airbnb",
           "--ignore-robots-txt"
         ]
       }
     }
   }

3. Starten Sie neu.

Konfiguration

Die Erweiterung bietet die folgenden benutzerkonfigurierbaren Optionen:

Ignore robots.txt

• Typ: Boolean (Checkbox)

• Standard: false

• Beschreibung: Umgeht robots.txt-Beschränkungen bei Anfragen an Airbnb

• Empfehlung: Lassen Sie dies deaktiviert, es sei denn, es wird für Testzwecke benötigt

Disable third-party geocoding

• Typ: Boolean (Checkbox)

• Umgebungsvariable: DISABLE_GEOCODING

• Standard: false

• Beschreibung: Überspringt den Photon/Nominatim-Geocoding-Schritt und lässt Airbnb den Standort-String selbst auflösen. Die Aktivierung stellt das Verhalten vor dem PR wieder her — jede Suche geht nur an airbnb.com, keine Drittanbieter-Aufrufe.

• Empfehlung: Lassen Sie dies deaktiviert, es sei denn, Sie benötigen explizit null ausgehenden Datenverkehr an Dritte. Wenn es aktiviert ist, könnten Nicht-US-Suchen falsche Ergebnisse liefern. Siehe Externe Dienste.

Tools

airbnb_search

Suchen Sie nach Airbnb-Unterkünften mit umfassenden Filteroptionen.

Parameter:

• location (erforderlich): Zu durchsuchender Standort (z. B. "San Francisco, CA"). Wenn ohne placeId angegeben, geocodiert der Server diesen String clientseitig über Photon/Nominatim — siehe Externe Dienste.

• placeId (optional): Google Maps Place ID. Überschreibt location und überspringt das clientseitige Geocoding vollständig (keine Drittanbieter-Aufrufe).

• checkin (optional): Check-in-Datum im Format YYYY-MM-DD

• checkout (optional): Check-out-Datum im Format YYYY-MM-DD

• adults (optional): Anzahl der Erwachsenen (Standard: 1)

• children (optional): Anzahl der Kinder (Standard: 0)

• infants (optional): Anzahl der Kleinkinder (Standard: 0)

• pets (optional): Anzahl der Haustiere (Standard: 0)

• minPrice (optional): Mindestpreis pro Nacht

• maxPrice (optional): Höchstpreis pro Nacht

• cursor (optional): Paginierungs-Cursor zum Durchsuchen von Ergebnissen

• propertyType (optional): Filtern nach Unterkunftstyp — entire_home, private_room, shared_room oder hotel_room

• ignoreRobotsText (optional): Überschreiben der robots.txt für diese Anfrage

Rückgabe:

• Suchergebnisse mit Objektdetails, Preisen und Direktlinks

• Paginierungsinformationen zum Durchsuchen weiterer Ergebnisse

• Such-URL als Referenz

airbnb_listing_details

Erhalten Sie detaillierte Informationen zu einer bestimmten Airbnb-Unterkunft.

Parameter:

• id (erforderlich): Airbnb-Objekt-ID

• checkin (optional): Check-in-Datum im Format YYYY-MM-DD

• checkout (optional): Check-out-Datum im Format YYYY-MM-DD

• adults (optional): Anzahl der Erwachsenen (Standard: 1)

• children (optional): Anzahl der Kinder (Standard: 0)

• infants (optional): Anzahl der Kleinkinder (Standard: 0)

• pets (optional): Anzahl der Haustiere (Standard: 0)

• ignoreRobotsText (optional): Überschreiben der robots.txt für diese Anfrage

Rückgabe:

• Detaillierte Objektinformationen einschließlich:

  • Standortdetails mit Koordinaten

  • Ausstattung und Einrichtungen

  • Hausregeln und Richtlinien

  • Objekt-Highlights und Beschreibungen

  • Direktlink zur Unterkunft

Technische Details

Architektur

• Laufzeit: Node.js 18+

• Protokoll: Model Context Protocol (MCP) via stdio-Transport

• Format: MCP Bundle (MCPB) v0.3

• Abhängigkeiten: Minimale externe Abhängigkeiten für Sicherheit und Zuverlässigkeit

Externe Dienste

Zusätzlich zu airbnb.com führt der Server Geocoding-Anfragen an zwei Drittanbieterdienste durch, um Standortabfragen in genaue Kartenbegrenzungsrahmen zu übersetzen. Dies umgeht den serverseitigen Geocoder von Airbnb, der für viele Nicht-US-Anfragen falsche Ergebnisse liefert (z. B. "Paris, Frankreich" landet in der Vendée; "Kopenhagen, Dänemark" landet in Wisconsin).

Jede Suche sendet nur den location-String aus der Anfrage an den Geocoder — keine anderen Anfragedaten, kein IP-Geolokalisierung, keine Tracking-Identifikatoren. Der Standort-String selbst ist natürlich derselbe, den der Benutzer eingegeben hat.

Opt-out: Es gibt zwei Möglichkeiten, die Geocoder zu überspringen:

• Pro Anfrage: Geben Sie eine explizite placeId an. Wenn placeId vorhanden ist, verwendet der Server direkt die eigene Ortssuche von Airbnb ohne Drittanbieter-Aufrufe.

• Global: Setzen Sie die Umgebungsvariable DISABLE_GEOCODING=true. Der Server überspringt Photon/Nominatim vollständig und übergibt den rohen Standort-String an Airbnb. Dies stellt das Verhalten vor dem PR für jede Suche wieder her und garantiert null ausgehenden Drittanbieter-Datenverkehr — auf Kosten fehlerhafter Ergebnisse für Nicht-US-Standorte, die der eigene Geocoder von Airbnb falsch verarbeitet. Standardmäßig false.

Wenn ein Geocoder nicht erreichbar ist oder kein Ergebnis zurückgibt, greift der Server darauf zurück, den Standort-String direkt an Airbnb zu senden, genau wie zuvor — der schlimmste Fall bei einem Ausfall ist also, dass internationale Suchen auf das vorherige (fehlerhafte) Verhalten zurückfallen, nicht dass die Suche vollständig fehlschlägt.

Fehlerbehandlung

• Umfassende Fehlerprotokollierung mit Zeitstempeln

• Sanfte Verschlechterung bei Änderungen der Seitenstruktur von Airbnb

• Timeout-Schutz für Netzwerkanfragen

• Detaillierte Fehlermeldungen zur Fehlerbehebung

Sicherheitsmaßnahmen

• Standardmäßige Robots.txt-Konformität

• Anfrage-Timeout-Limits

• Eingabevalidierung und -bereinigung

• Sichere Handhabung von Umgebungsvariablen

• Keine Speicherung sensibler Daten

Leistung

• Effizientes HTML-Parsing mit Cheerio

• Anfrage-Caching, wo angemessen

• Minimaler Speicherbedarf

• Schnelle Start- und Antwortzeiten

Kompatibilität

• Plattformen: macOS, Windows, Linux

• Node.js: 18.0.0 oder höher

• Claude Desktop: 0.10.0 oder höher

• Andere MCP-Clients: Kompatibel mit jeder MCP-unterstützenden Anwendung

Entwicklung

Bauen aus dem Quellcode

# Install dependencies
npm install

# Build the project
npm run build

# Watch for changes during development
npm run watch

Testen

Die Erweiterung kann durch direktes Ausführen des MCP-Servers getestet werden:

# Run with robots.txt compliance (default)
node dist/index.js

# Run with robots.txt ignored (for testing)
node dist/index.js --ignore-robots-txt

Rechtliche und ethische Überlegungen

• Respektieren Sie die Nutzungsbedingungen von Airbnb: Diese Erweiterung dient der legitimen Recherche und Buchungsunterstützung

• Robots.txt-Konformität: Die Erweiterung respektiert standardmäßig die robots.txt

• Ratenbegrenzung: Achten Sie auf die Anfragefrequenz, um die Server von Airbnb nicht zu überlasten

• Datennutzung: Extrahieren Sie nur öffentlich verfügbare Informationen für legitime Zwecke

Support

• Probleme: Melden Sie Fehler und Funktionsanfragen unter GitHub Issues

• Dokumentation: Zusätzliche Dokumentation im Repository verfügbar

• Community: Nehmen Sie an Diskussionen über die MCP- und MCPB-Entwicklung teil

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details.

Mitwirken

Beiträge sind willkommen! Bitte lesen Sie die Richtlinien für Mitwirkende und reichen Sie Pull Requests für Verbesserungen ein.

Hinweis: Diese Erweiterung ist nicht mit Airbnb, Inc. verbunden. Es ist ein unabhängiges Tool, das Benutzern helfen soll, öffentlich verfügbare Airbnb-Unterkünfte zu suchen und zu analysieren.