Communityライティング&編集github.com

scoutingapi/travel-skills

宿泊施設の検索、空室確認、価格比較、OTA横断比較、口コミをScoutingAPI経由で実現するポータブルなAIエージェントスキル(SKILL.md)。Claude、MCPなどで動作。MIT-0ライセンス。

travel-skills とは?

このスキルは、ScoutingAPIが提供するModel Context Protocol (MCP) サーバーと連携し、AIエージェントがAirbnb、Booking.com、Vrbo、Google Hotelsの宿泊データを直接ツールとして利用できるようにします。OAuth 2.1 + PKCEによるセキュアな認証を採用し、APIキーをエージェントに埋め込む必要がありません。7つの読み取り専用ツール(宿泊施設検索、空室確認、詳細取得、価格見積、OTA間比較、口コミ取得、非同期ジョブ状態確認)を通じて、対話型エージェントによる自然な宿泊情報の調査・比較を実現します。Claude Code、Claude Desktop、Claude.aiのカスタムコネクタとして簡単に追加でき、クレジット残高はREST APIと共有されるため、ScoutingAPIの既存利用者もスムーズに移行できます。非同期スクレイピングジョブはポーリングで結果を取得し、サンドボックスやキャッシュヒット時は即時応答するため、開発・テストも効率的です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add scoutingapi/travel-skills

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ScoutingAPI — MCPサーバーに接続する

ScoutingAPIはネイティブのModel Context Protocolサーバーを提供しており、エージェントはAirbnb、Booking.com、Vrbo、Google Hotelsの宿泊データをファーストクラスのツールとしてクエリできます。APIキーをエージェントに貼り付ける必要はありません。

接続(Claude.ai / Claude Desktop / Claude Code)

  1. エージェントのコネクタ設定を開き、カスタムコネクタを追加(MCPサーバー)します。
  2. URL https://mcp.scoutingapi.com を入力します。
  3. ブラウザのポップアップで表示されるOAuthプロンプトを完了します。これによりコネクタがScoutingAPIアカウントにリンクされます。(初回利用時:まずアカウントを作成しメールを確認してください。サンドボックスアカウントは評価用に使用できます。詳細は https://scoutingapi.com/docs/mcp を参照。)
  4. 以下の7つのツールがエージェントで使用可能になります。

7つの読み取り専用ツール

  • search_stays — 場所、日付、人数、フィルターに基づいてプラットフォーム横断で宿泊施設を検索します。
  • check_availability — 既知の物件について、指定した期間の日単位の空室状況を確認します。
  • get_listing — 1件の物件の詳細情報(アメニティ、写真、ホスト、評価)を取得します。
  • get_price — 特定の日付と人数に対する1件の物件のリアルタイム価格見積を取得します。
  • compare_prices — 1件の物件をOTA間で比較し、最小価格と中央値を計算します。
  • get_reviews — 1つのプラットフォーム上の1件の物件について、整形・ページングされた口コミを取得します。
  • get_job — 非同期スクレイピングジョブのステータスをポーリングし、結果を取得します(コスト0)。

非同期動作

ツールはRESTと同じ非同期契約に従います。スクレイピングが必要なライブ呼び出しは保留中のジョブを返します。エージェント(またはツールレイヤー)は、返されたjobIdを使用してget_jobをポーリングし、ジョブが完了すると結果ペイロードがdata.resultに格納されます。サンドボックスおよびキャッシュヒットの場合は即座に返されます。

クレジットと制限

MCP呼び出しはRESTキーと同じ単一のクレジット残高から消費されますが、レート制限はユーザーごとに別のバケットで適用されます。コストとレート制限: https://scoutingapi.com/pricing。

MCP vs REST — どちらを使うべきか

  • MCP — コネクタをサポートする対話型エージェント/アシスタント(Claudeなど)に最適です。キー管理が不要で、ツールがモデルにネイティブに公開されます。
  • REST(スキル: scoutingapi-search) — プログラムによるバックエンド、サーバー、cronジョブ、MCPをサポートしないランタイムに最適です。Bearerキーと@scoutingapi/sdkを使用します。

どちらも同じデータと統一されたスキーマにアクセスします。ドキュメント: https://scoutingapi.com/docs/mcp。

関連スキル