Community寫作與編輯github.com

scoutingapi/travel-skills

可攜式 AI 代理技能 (SKILL.md),用於住宿搜尋、可用性、定價、跨 OTA 比較與評論,透過 ScoutingAPI 實現。支援 Claude、MCP 等。MIT-0 授權。

travel-skills 是什麼?

ScoutingAPI/travel-skills 提供一套可攜式的 AI 代理技能,專門用於旅遊住宿資料的查詢與比較。它支援多個主流平台,包括 Airbnb、Booking.com、Vrbo 與 Google Hotels,並以工具的形式整合進 Claude、Claude Desktop、Claude Code 等支援模型上下文協議 (MCP) 的代理程式中。此技能的核心優勢在於無需手動管理 API 金鑰,而是透過 OAuth 2.1 + PKCE 的授權流程,將代理程式安全連結至使用者的 ScoutingAPI 帳戶與信用額度。其提供的七個唯讀工具涵蓋住宿搜尋、逐日可用性檢查、詳細房源資訊、即時報價、跨 OTA 價格比較、評論查詢與非同步任務狀態輪詢,能滿足多樣化的旅遊規劃需求。代理程式會自動處理非同步工作(如即時爬蟲)的輪詢,而快取命中或沙箱模式則立即回傳結果。MCP 呼叫與 REST API 共享同一信用額度,但具有獨立的速率限制。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ScoutingAPI — 連接 MCP 伺服器

ScoutingAPI 提供了原生的模型上下文協定伺服器,讓代理程式能將 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. 以下七個工具便可供代理程式使用。

七個唯讀工具

  • 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。

相關技能