跨 OTA 比较指定日期酒店房价时…

在需要比较 Booking.com、Agoda、Traveloka 与 OpenTravel 同一酒店同一日期的实时房价、找出最便宜渠道及免费取消条款时使用。

适用场景

解决思路

1. 确认已接入 `pricewin` MCP server；本技能自身不发网络请求，比较是在返回的 sources 上做的，没有服务端 compare 调用。
2. 按用户输入选择入口：给了城市 → `search_hotels_live` → `poll_search_results`；给了具体酒店名 → `get_ota_hotel_detail`；已知是 OpenTravel 直连（`source: "OPENTRAVEL_DIRECT"` 且有 `propertyId`）→ `get_hotel_detail`。
3. 城市级比较：调用 `search_hotels_live`，必填 `city`、`checkIn`、`checkOut`（YYYY-MM-DD），可选 `adults`（默认 2）、`rooms`、`area`、`hotelName`、`priceMin`、`priceMax`、`language`；该调用立即返回 `sessionId`，不返回酒店。
4. 等待 5 秒后调用 `poll_search_results(sessionId, nights)`。
5. 当 `status` 为 `pending` 或 `partial` 时，每 5 秒再轮询一次，最多 18 次（90 秒）。
6. 一旦 `status == "partial"` 且已有酒店就立即展示，同时继续静默轮询并细化结果。
7. 随后对每家酒店跨其 sources 做比较；去重与展示契约遵循 `pricewin-hotel-search`，不要另立说法。
8. 单个指定酒店：调用 `get_ota_hotel_detail`，必填 `checkIn`、`checkOut`，已知时传入 `hotelName` + `city` + `queryText`（用户原文）。
9. 指定酒店场景不要调用 `search_hotels_live`，那会返回整城列表。
10. `get_ota_hotel_detail` 是实时抓取，约 20–60 秒；在真正返回前不要提“加载中”。
11. 加速：若先前搜索已给出 `prices.booking.url`，作为 `propertyUrl` 传入以跳过名称解析。
12. 若因负载返回 not-found，重试一次。
13. OpenTravel 直连：仅对 `source: "OPENTRAVEL_DIRECT"` 的结果调用 `get_hotel_detail`；有 `propertyId`（来自 `opentravelResults[].propertyId` 的 UUID）时优先传它，`hotelName` + `city` 仅作为已确认 OpenTravel 直连酒店的兜底；必填 `checkIn`、`checkOut`，可选 `adults`、`children`、`language`；返回带 `roomTypeId` 和 `ratePlanId` 的房型，这些才使酒店可预订。
14. 路由规则：有 `propertyId` → `get_hotel_detail`；只有名称 → `get_ota_hotel_detail`。
15. 取消条款：仅对 OpenTravel rate plan 调用 `get_cancellation_policy(propertyId, ratePlanId, checkInDate)`，得到不可退款标志、免费取消窗口、退款比例和计算出的截止时间；`ratePlanId` 来自 `get_hotel_detail` → `roomTypes[].ratePlanId`；必须传 `checkInDate`，否则拿不到截止时间；OTA 酒店没有结构化政策，引用抓取返回的内容即可。
16. 展示比较结果：纯粹按价格排序，任何来源（包括 OpenTravel）都不优先；最便宜的来源放最前，其余列在下方，格式如 `Agoda $X · Booking $Y · OpenTravel $Z`。
17. 计算相对次便宜来源的节省：`(next - cheapest) / next * 100` → “Save Z%”。
18. 当价差很小时，优先选可免费取消的选项并说明原因。
19. 除非工具另有说明，所有价格均为 USD，不做汇率换算。
20. 工具输入与响应字段见 reference.md。
21. 安全与数据处理：本技能仅为文档，无代码、无依赖、自身无网络调用；唯一发送的数据是比较查询（城市或酒店名、日期、住客数，以及 `queryText` 即用户原文），发往 PriceWin 托管的 MCP server `https://mcp.price.win/mcp`（无凭据、无账号）；不含 PII，本技能不能预订或支付；完整披露见 SECURITY.md。

适用边界 · 注意事项

• 未接入 `pricewin` MCP server 时不可用。
• 用户只给了酒店名时，不要用 `search_hotels_live`（会返回整城列表）。
• 不要对非 `OPENTRAVEL_DIRECT` 来源的结果调用 `get_hotel_detail`，也不要对 OTA 酒店期待结构化取消政策。