ScoutingAPI — MCPサーバーに接続する
ScoutingAPIはネイティブのModel Context Protocolサーバーを提供しており、エージェントはAirbnb、Booking.com、Vrbo、Google Hotelsの宿泊データをファーストクラスのツールとしてクエリできます。APIキーをエージェントに貼り付ける必要はありません。
- サーバーURL: https://mcp.scoutingapi.com (Streamable HTTPトランスポート)。
- 認証: OAuth 2.1 + PKCE(S256) + 動的クライアント登録。ブラウザのポップアップで一度認証すれば、コネクタはScoutingAPIアカウントとそのクレジット残高にリンクされます。
- OAuth保護リソースメタデータ(RFC 9728): https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
接続(Claude.ai / Claude Desktop / Claude Code)
- エージェントのコネクタ設定を開き、カスタムコネクタを追加(MCPサーバー)します。
- URL
https://mcp.scoutingapi.comを入力します。 - ブラウザのポップアップで表示されるOAuthプロンプトを完了します。これによりコネクタがScoutingAPIアカウントにリンクされます。(初回利用時:まずアカウントを作成しメールを確認してください。サンドボックスアカウントは評価用に使用できます。詳細は https://scoutingapi.com/docs/mcp を参照。)
- 以下の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。