Community写作与编辑github.com

scoutingapi/travel-skills

可移植的AI智能体技能包(SKILL.md),用于住宿搜索、可用性查询、价格对比、跨OTA比价及评论查看,基于ScoutingAPI。兼容Claude、MCP等平台。MIT-0协议。

travel-skills 是什么?

ScoutingAPI的旅行技能包为AI智能体(如Claude、Cursor等)提供了一组可移植的、面向住宿搜索的API技能。它通过原生的Model Context Protocol(MCP)服务器,让智能体能够像使用原生工具一样查询Airbnb、Booking.com、Vrbo和Google Hotels等平台的住宿数据。该技能包包含七个只读工具,涵盖搜索房源、检查可用性、获取详情与报价、跨OTA比价以及查看评论等核心功能。开发者只需通过OAuth 2.1+PKCE认证即可连接,无需手动管理API密钥。同时,它还支持异步任务轮询,确保实时数据抓取的可靠性。无论是用于交互式助手(MCP协议)还是程序化后端(REST协议),该技能包都能提供统一的数据架构和一致的开发体验。

兼容平台✓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 提供了一个原生 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. 以下七个工具将对智能体可用。

七个只读工具

  • search_stays — 按地点、日期、入住人数、筛选条件跨平台搜索住宿。
  • check_availability — 针对已知房源的逐日可用性(指定日期窗口)。
  • get_listing — 获取单个房源的完整信息(设施、照片、房东、评分)。
  • get_price — 获取单个房源在特定日期和入住人数下的实时报价。
  • compare_prices — 跨 OTA 比较同一房源的价格,并计算最低价和中位数。
  • get_reviews — 获取单个房源在某一平台上的规范化、分页评论。
  • get_job — 轮询异步抓取任务的状态并获取结果(消耗 0 信用点)。

异步行为

这些工具遵循与 REST 相同的异步契约:需要抓取数据的实时调用会返回一个待处理的任务; 智能体(或工具层)会使用返回的 jobId 轮询 get_job,直到任务完成, 结果载荷会出现在 data.result 下。沙盒和缓存命中会立即返回结果。

信用点与限制

MCP 调用与您的 REST 密钥共用 同一信用点余额,但会基于 独立的每个用户桶 进行速率限制。费用和速率限制:https://scoutingapi.com/pricing。

MCP vs REST — 使用场景

  • MCP — 最适合支持连接器的交互式智能体/助手(例如 Claude): 使用 OAuth 而非密钥管理,工具原生呈现给模型。
  • REST(技能包:scoutingapi-search) — 最适合程序化后端、服务器、定时任务, 以及任何不支持 MCP 的运行环境:使用 Bearer 密钥 + @scoutingapi/sdk。

两者访问相同的数据和统一的数据架构。文档:https://scoutingapi.com/docs/mcp。

相关技能