pricewin-price-comparison

Original：🇺🇸 English

Translated

Compare live hotel room rates across Booking.com, Agoda, Traveloka, and OpenTravel for specific dates — which OTA is cheapest for the same property, per-room prices, and free-cancellation terms. Use when comparing hotel prices, checking room rates for a named hotel, asking which site is cheaper, or finding the best rate for given check-in/check-out dates.

364installs

Sourceprice-win/pricewin-skills-hub

Added on2026-08-02

NPX Install

npx skill4agent add price-win/pricewin-skills-hub pricewin-price-comparison

SKILL.md Content

View Translation Comparison →

Requires the
pricewin
MCP 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
```
status
```
is
```
pending
```
or
```
partial
```
: 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
```
. Pass
```
hotelName
```
+
```
city
```
+
```
queryText
```
(verbatim user text) whenever known
Do NOT call
search_hotels_live
for 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 as
```
propertyUrl
```
to 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 from

opentravelResults[].propertyId

) when available

```
hotelName
```
+
```
city
```
is a fallback only for a property already confirmed as OpenTravel direct
Required:
```
checkIn
```
,
```
checkOut
```
. Optional:
```
adults
```
,
```
children
```
,
```
language
```
Returns room types with
```
roomTypeId
```
and
```
ratePlanId
```
— 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.