ScoutingAPI — 連接 MCP 伺服器
ScoutingAPI 提供了原生的模型上下文協定伺服器,讓代理程式能將 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。)
- 以下七個工具便可供代理程式使用。
七個唯讀工具
search_stays— 根據地點、日期、入住人數、篩選條件,跨平台搜尋住宿。check_availability— 針對已知房源,查詢特定日期範圍內的逐日可用性。get_listing— 取得單一房源的完整詳細資料(設施、照片、房東、評分)。get_price— 為特定日期和入住人數,取得單一房源的即時價格報價。compare_prices— 比較同一物業在各 OTA 上的價格,並計算最低價與中位數。get_reviews— 取得單一平台上一則房源的正規化、分頁評論。get_job— 輪詢非同步爬蟲工作的狀態並取得結果(不消耗額度)。
非同步行為
這些工具與 REST API 共享相同的非同步合約:需要即時爬取的呼叫會傳回一個待處理的工作;代理程式(或工具層)會使用傳回的 jobId 輪詢 get_job,直到工作完成,而結果負載會出現在 data.result 下。沙箱和快取命中則會立即回傳結果。
額度與限制
MCP 呼叫與您的 REST 金鑰共用同一個信用餘額,但其速率限制是基於獨立的使用者儲存桶來計算。費用與速率限制:https://scoutingapi.com/pricing。
MCP 與 REST — 使用時機
- MCP — 最適合支援連接器的互動式代理程式/助手(例如 Claude):使用 OAuth 而非金鑰管理,工具原生呈現給模型。
- REST (技能:scoutingapi-search) — 最適合程式化後端、伺服器、定時任務,以及任何不支援 MCP 的執行環境:使用 Bearer 金鑰搭配
@scoutingapi/sdk。
兩者皆可存取相同的資料與相同的統一 schema。文件:https://scoutingapi.com/docs/mcp。