用途:该技能依赖 pricewin MCP 服务器,比较同一酒店在 Booking.com、Agoda、Traveloka(抓取)与 OpenTravel(直连 API)上的实时房价,并找出最便宜渠道。它自身不发起网络调用,也没有服务端比价接口,比较由使用者在返回结果上完成;不能预订或支付,也不涉及账号凭证。
主要能力与用法:按用户输入选择入口。城市比价用 search_hotels_live——必填 city、checkIn、checkOut(YYYY-MM-DD),可选 adults(默认 2)、rooms、area、hotelName、priceMin、priceMax、language;该调用立即返回 sessionId 而不返回酒店,需等 5 秒后 poll_search_results(sessionId, nights),状态为 pending 或 partial 时每 5 秒再轮询,最多 18 次(90 秒),出现 hotels 即可展示,同时静默继续轮询细化。指定酒店名用 get_ota_hotel_detail(必填 checkIn、checkOut,尽量传 hotelName、city 与原文 queryText),不要对该场景调用 search_hotels_live;实时抓取约 20–60 秒,若已知 prices.booking.url 可作 propertyUrl 跳过名称解析,负载下未找到可重试一次。仅对 source 为 OPENTRAVEL_DIRECT 且有 propertyId 的结果用 get_hotel_detail(propertyId 为 opentravelResults[].propertyId 的 UUID;hotelName+city 仅作已确认直连酒店的兜底),必填 checkIn、checkOut,可选 adults、children、language,返回含 roomTypeId 与 ratePlanId 的房型,这是可预订的关键。路由规则:有 propertyId 用 get_hotel_detail,仅有名称用 get_ota_hotel_detail。仅 OpenTravel 费率计划可用 get_cancellation_policy(propertyId, ratePlanId, checkInDate) 获取不可退款标记、免费取消窗口、退款比例与计算出的截止时间;ratePlanId 来自 get_hotel_detail 的 roomTypes[].ratePlanId,须传 checkInDate 才有截止时间;OTA 酒店无结构化政策,只能引用抓取到的内容。
展示:纯按价格排序,不区分来源优先级;最便宜的来源排最前,如 Agoda $X · Booking $Y · OpenTravel $Z;与次低价相比按 (next - cheapest) / next * 100 计算并标注 Save Z%;差距小时优先免费取消选项并说明原因;未特别说明时价格均为美元,不做换算。
限制:仅覆盖上述四类来源;依赖 PriceWin 托管 MCP 服务器 https://mcp.price.win/mcp,无凭证与账号,发送的数据仅为比价查询(城市或酒店名、日期、住客数及 queryText 原文),无 PII。其余工具输入与响应字段见 reference.md,安全细节见 SECURITY.md。