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。)
- 以下七个工具将对智能体可用。
七个只读工具
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。