CommunityRédaction et éditiongithub.com

scoutingapi/skills-voyage

Compétences portables pour agents IA (SKILL.md) dédiées à la recherche d'hébergements, la disponibilité, les prix, la comparaison multi-OTA et les avis via ScoutingAPI. Fonctionne avec Claude, MCP et plus. Licence MIT-0.

Qu'est-ce que skills-voyage ?

Ce skill transforme l'agent IA en un assistant de recherche de voyages capable d'interroger directement les données d'hébergement d'Airbnb, Booking.com, Vrbo et Google Hotels. Il expose sept outils en lecture seule via le protocole MCP (Model Context Protocol) : recherche de séjours, vérification de disponibilité, détails d'une annonce, devis de prix, comparaison multi-plateformes, avis clients et suivi de tâches asynchrones. L'authentification se fait par OAuth 2.1 + PKCE, sans clé API à coller. Idéal pour Claude (Desktop, Code, web) et tout agent compatible MCP, ce skill permet de planifier des voyages, comparer les offres et analyser les avis sans quitter l'interface de l'agent.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add scoutingapi/travel-skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

ScoutingAPI — connecter le serveur MCP

ScoutingAPI fournit un serveur Model Context Protocol natif, permettant à un agent d'interroger les données d'hébergement d'Airbnb, Booking.com, Vrbo et Google Hotels comme des outils intégrés — sans clé API à coller dans l'agent.

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

  1. Ouvrez les paramètres de connecteur de votre agent et ajoutez un connecteur personnalisé (serveur MCP).
  2. Utilisez l'URL https://mcp.scoutingapi.com.
  3. Terminez l'invite OAuth dans la popup du navigateur — cela lie le connecteur à votre compte ScoutingAPI. (Premiers utilisateurs : créez un compte et vérifiez l'e-mail d'abord ; un compte sandbox fonctionne pour l'évaluation. Voir https://scoutingapi.com/docs/mcp.)
  4. Les sept outils ci-dessous deviennent disponibles pour l'agent.

Les sept outils en lecture seule

  • search_stays — rechercher des séjours sur les plateformes par lieu, dates, occupation, filtres.
  • check_availability — disponibilité jour par jour pour une annonce connue sur une période.
  • get_listing — détails complets d'une annonce (équipements, photos, hôte, évaluations).
  • get_price — un devis de prix réel pour une annonce pour des dates + occupation spécifiques.
  • compare_prices — comparer une propriété sur plusieurs OTA avec min + médiane calculés.
  • get_reviews — avis normalisés et paginés pour une annonce sur une plateforme.
  • get_job — interroger le statut + récupérer les résultats d'un travail de scraping asynchrone (coût 0).

Comportement asynchrone

Les outils partagent le même contrat asynchrone que REST : un appel en direct qui doit scraper renvoie un travail en attente ; l'agent (ou la couche d'outils) interroge get_job avec le jobId renvoyé jusqu'à ce qu'il se termine, et la charge utile des résultats arrive sous data.result. Les hits en sandbox et dans le cache reviennent immédiatement.

Crédits et limites

Les appels MCP puisent dans le même solde de crédits unique que vos clés REST, mais sont limités en débit sur un groupe séparé par utilisateur. Coûts et limites : https://scoutingapi.com/pricing.

MCP contre REST — lequel utiliser

  • MCP — idéal pour les agents/assistants interactifs (ex. Claude) qui prennent en charge les connecteurs : OAuth au lieu de la gestion des clés, outils exposés nativement au modèle.
  • REST (skill : scoutingapi-search) — idéal pour les backends programmatiques, serveurs, tâches cron et tout environnement sans support MCP : une clé Bearer + le @scoutingapi/sdk.

Les deux accèdent aux mêmes données et au même schéma unifié. Documentation : https://scoutingapi.com/docs/mcp.

Skills associés