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.
- URL du serveur : https://mcp.scoutingapi.com (transport HTTP Streamable).
- Authentification : OAuth 2.1 + PKCE (S256) avec enregistrement dynamique du client. Vous autorisez une fois dans une popup de navigateur ; le connecteur est lié à votre compte ScoutingAPI et à son solde de crédits.
- Métadonnées de ressource protégée OAuth (RFC 9728) : https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
Connexion (Claude.ai / Claude Desktop / Claude Code)
- Ouvrez les paramètres de connecteur de votre agent et ajoutez un connecteur personnalisé (serveur MCP).
- Utilisez l'URL
https://mcp.scoutingapi.com. - 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.)
- 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.