Imported from price-win/pricewin-skills-hub (
skills/pricewin-price-comparison/SKILL.md) via skills.sh. Install upstream withnpx skills add price-win/pricewin-skills-hub --skill pricewin-price-comparison. Copyright stays with the author.
Requires the
pricewinMCP server. This skill issues no network calls of its own.
Price Comparison
MCP server: pricewin. Compares live rates across Booking.com, Agoda, Traveloka (crawled) plus OpenTravel (direct API).
Comparison is something you do over the returned sources — there is no server-side compare call. Pick the entry point by what the user gave you:
| User gave you | Tool |
|---|---|
| A city — "compare hotel prices in Da Nang" | search_hotels_live → poll_search_results |
| A named hotel — "is Mercure Danang cheaper on Agoda or Booking?" | get_ota_hotel_detail |
A hotel already known to be OpenTravel direct (source: "OPENTRAVEL_DIRECT", has propertyId) |
get_hotel_detail |
City-wide comparison
search_hotels_live returns IMMEDIATELY with a sessionId — it does not return hotels.
search_hotels_live— required:city,checkIn,checkOut(YYYY-MM-DD). Optional:adults(default 2),rooms,area,hotelName,priceMin,priceMax,language- Wait 5s →
poll_search_results(sessionId, nights) - While
statusispendingorpartial: wait 5s and poll again — up to 18 times (90s) - Present as soon as
status == "partial"with hotels; keep polling silently and refine
Then compare per hotel across its sources. See pricewin-hotel-search
for the full dedupe + presentation contract — do not restate it differently here.
Single named hotel
get_ota_hotel_detail — for one specific Booking.com/Agoda hotel the user named.
- Required:
checkIn,checkOut. PasshotelName+city+queryText(verbatim user text) whenever known - Do NOT call
search_hotels_livefor a named hotel — that returns a whole-city list - Live crawl, ~20–60s. Say nothing about "loading" until it actually returns
- Speed-up: if a prior search already gave you
prices.booking.url, pass it aspropertyUrlto skip name resolution - If it returns not-found under load, retry once
Returns rooms, prices, facilities, photos, reviews for that property.
OpenTravel direct properties
get_hotel_detail — only for results with source: "OPENTRAVEL_DIRECT".
- Pass
propertyId(UUID fromopentravelResults[].propertyId) when available hotelName+cityis a fallback only for a property already confirmed as OpenTravel direct- Required:
checkIn,checkOut. Optional:adults,children,language - Returns room types with
roomTypeIdandratePlanId— these are what make a property bookable
⚠️ Router rule: have a propertyId → get_hotel_detail. Name only → get_ota_hotel_detail.
Cancellation terms
For OpenTravel rate plans only: get_cancellation_policy(propertyId, ratePlanId, checkInDate)
→ non-refundable flag, free-cancellation window, refund %, and the computed deadline.
ratePlanId comes from get_hotel_detail → roomTypes[].ratePlanId. Pass checkInDate
or you get no deadline. OTA hotels have no structured policy — quote whatever the crawl returned.
Presenting a comparison
- Rank purely by price. No source gets priority, OpenTravel included
- Show the cheapest source first, then the others underneath:
Agoda $X · Booking $Y · OpenTravel $Z - Savings vs the next-cheapest source:
(next - cheapest) / next * 100→ "Save Z%" - When the gap is small, prefer the free-cancellation option and say why
- All prices USD unless the tool says otherwise. No conversion
Tool inputs and response fields: reference.md.
Security & data handling
Documentation only — no code, no dependencies, no network calls of its own. The
only data sent is the comparison query (city or hotel name, dates, guests, plus
queryText — the user's message verbatim), to PriceWin's hosted MCP server
https://mcp.price.win/mcp (no credentials, no account). No PII, and this skill
cannot book or pay for anything. Full disclosure — operator, backend provenance,
exact fields per tool — in SECURITY.md.