CommunitySchreiben & Editierengithub.com

ScoutingAPI – Reise-Skills

Tragbare KI-Agenten-Skills (SKILL.md) für Unterkunftssuche, Verfügbarkeit, Preise, plattformübergreifenden OTA-Vergleich und Bewertungen über die ScoutingAPI. Funktioniert mit Claude, MCP und mehr. MIT-0.

Was ist ScoutingAPI – Reise-Skills?

Dieses Skill-Bundle ermöglicht es KI-Agenten, über das Model Context Protocol (MCP) auf Echtzeit-Unterkunftsdaten von Airbnb, Booking.com, Vrbo und Google Hotels zuzugreifen. Es bietet sieben schreibgeschützte Werkzeuge für Aufgaben wie die Suche nach Aufenthalten, die Prüfung der Tagesverfügbarkeit, den Abruf detaillierter Listings, die Ermittlung von Echtzeit-Preisangeboten und den plattformübergreifenden OTA-Preisvergleich. Der MCP-Server verwendet OAuth 2.1 + PKCE zur Authentifizierung, sodass kein API-Schlüssel manuell eingegeben werden muss – die Autorisierung erfolgt einmalig über einen Browser-Popup. Die Tools folgen einem asynchronen Vertrag: Live-Scraping-Jobs geben einen Job zurück, der über das Werkzeug „get_job“ abgefragt wird, bis er abgeschlossen ist. Sandbox-Anfragen und Cache-Treffer liefern sofortige Ergebnisse. Dieses Skill eignet sich ideal für interaktive Assistenten wie Claude, die MCP-Connectors unterstützen, während das REST-Pendant (scoutingapi-search) besser für programmatische Backends geeignet ist. Beide Schnittstellen greifen auf dieselben Daten und dasselbe einheitliche Schema zu.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add scoutingapi/travel-skills

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ScoutingAPI — Verbinde den MCP-Server

ScoutingAPI liefert einen nativen Model Context Protocol Server, sodass ein Agent Unterkunftsdaten von Airbnb, Booking.com, Vrbo und Google Hotels als erstklassige Werkzeuge abfragen kann – ohne dass ein API-Schlüssel in den Agenten eingefügt werden muss.

Verbinden (Claude.ai / Claude Desktop / Claude Code)

  1. Öffne die Connector-Einstellungen deines Agenten und füge einen benutzerdefinierten Connector (MCP-Server) hinzu.
  2. Verwende die URL https://mcp.scoutingapi.com.
  3. Schließe den OAuth-Dialog im Browser-Popup ab – dies verknüpft den Connector mit deinem ScoutingAPI-Konto. (Erstnutzer: Erstelle ein Konto und bestätige zuerst die E-Mail; ein Sandbox-Konto funktioniert für Testzwecke. Siehe https://scoutingapi.com/docs/mcp.)
  4. Die sieben untenstehenden Werkzeuge stehen dem Agenten zur Verfügung.

Die sieben schreibgeschützten Werkzeuge

  • search_stays — Suche nach Aufenthalten auf verschiedenen Plattformen nach Ort, Daten, Belegung, Filtern.
  • check_availability — Tagesgenaue Verfügbarkeit für ein bekanntes Inserat über einen Datumsbereich.
  • get_listing — Vollständige Details zu einem Inserat (Ausstattung, Fotos, Gastgeber, Bewertungen).
  • get_price — Ein echtes Preisangebot für ein Inserat für bestimmte Daten + Belegung.
  • compare_prices — Vergleiche eine Unterkunft über mehrere OTAs hinweg mit berechnetem Minimum + Median.
  • get_reviews — Normalisierte, paginierte Bewertungen für ein Inserat auf einer Plattform.
  • get_job — Status abfragen + Ergebnisse eines asynchronen Scraping-Jobs abrufen (kostet 0).

Asynchrones Verhalten

Die Werkzeuge folgen dem gleichen asynchronen Vertrag wie die REST-API: Ein Live-Aufruf, der scrapen muss, gibt einen ausstehenden Job zurück; der Agent (oder die Werkzeugschicht) fragt get_job mit der zurückgegebenen jobId ab, bis dieser abgeschlossen ist, und das Ergebnis befindet sich unter data.result. Sandbox- und Cache-Treffer liefern sofortige Ergebnisse.

Guthaben & Limits

MCP-Aufrufe werden vom gleichen einheitlichen Guthaben wie deine REST-Schlüssel abgezogen, unterliegen jedoch einem separaten Rate-Limit pro Benutzer. Kosten und Limits: https://scoutingapi.com/pricing.

MCP vs. REST – Welches verwenden

  • MCP — am besten für interaktive Agenten/Assistenten (z. B. Claude), die Connectors unterstützen: OAuth statt Schlüsselverwaltung, Werkzeuge werden dem Modell nativ angeboten.
  • REST (Skill: scoutingapi-search) — am besten für programmatische Backends, Server, Cron-Jobs und jede Laufzeit ohne MCP-Unterstützung: ein Bearer-Key + das @scoutingapi/sdk.

Beide greifen auf dieselben Daten und dasselbe einheitliche Schema zu. Dokumentation: https://scoutingapi.com/docs/mcp.

Verwandte Skills