# Pricewin Price Comparison

> Compara tarifas de habitación en vivo entre Booking.com, Agoda, Traveloka y OpenTravel para fechas concretas: qué OTA es más barata, precio por habitación y condiciones de cancelación gratuita.

Fuente: https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-price-comparison
Markdown: https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-price-comparison.md

Repositorio: https://github.com/Price-Win/pricewin-skills-hub
Autor: Price-Win
Licencia: MIT-0
Actualizado: hace 22 días
Coste de contexto: 90 tok instalada, 1.2k tok al activarse, 3.6k tok con todos los archivos del bundle
Bundle: 4 archivos, 14 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent claude-code
# Cursor
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent cursor
# Codex
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent codex
# Gemini CLI
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent gemini
# Windsurf
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent windsurf
# Cline
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-price-comparison --agent cline
```

## Qué hace

- Compara tarifas de habitación en vivo entre Booking.com, Agoda, Traveloka y OpenTravel para fechas concretas
- Elige la herramienta de entrada según lo que dio el usuario: ciudad, nombre de hotel u hotel OpenTravel confirmado
- Muestra la fuente más barata primero y calcula el ahorro frente a la siguiente fuente
- Consulta condiciones de cancelación gratuita para tarifas OpenTravel

## Cuándo usarla

- Comparar precios de hotel entre distintas OTAs
- Consultar tarifas de habitación para un hotel concreto
- Preguntar qué sitio es más barato o encontrar la mejor tarifa para unas fechas

## Qué la activa

- "¿Es más barato el Mercure Danang en Agoda o en Booking?"
- "Compara precios de hotel en Da Nang para estas fechas"
- "¿Cuáles son las condiciones de cancelación gratuita de esta tarifa?"

## Antes de instalar

- Necesita el servidor MCP `pricewin`; no hace llamadas de red propias.

## Archivos

- SECURITY.md — 3 KB
- SKILL.md — 5 KB
- reference.md — 3 KB
- skill-card.md — 3 KB

## SKILL.md

Reproducido tal cual desde Price-Win/pricewin-skills-hub bajo MIT-0. Esta sección es el documento original y está en inglés.

> 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.

1. `search_hotels_live` — required: `city`, `checkIn`, `checkOut` (YYYY-MM-DD). Optional: `adults` (default 2), `rooms`, `area`, `hotelName`, `priceMin`, `priceMax`, `language`
2. Wait 5s → `poll_search_results(sessionId, nights)`
3. While `status` is `pending` or `partial`: wait 5s and poll again — up to 18 times (90s)
4. Present as soon as `status == "partial"` with hotels; keep polling silently and refine

Then compare per hotel across its sources. See [`pricewin-hotel-search`](../pricewin-hotel-search/SKILL.md)
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](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`](./SECURITY.md).

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [Price-Win](https://skillsagentes.com/creators/price-win.md) — 0 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Pricewin Hotel Deal Finder](https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-hotel-deal-finder.md): Encuentra el hotel más barato comparando precios en vivo en Booking.com, Agoda, Google Hotels y OpenTravel para cualquier ciudad y fechas, con picks de mejor valor, más barato y calidad, y enlaces de reserva.
- [Pricewin Hotel Search](https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-hotel-search.md): Busca hoteles en vivo en Agoda, Booking.com, Traveloka y OpenTravel con precios en tiempo real para fechas concretas. Para consultar precios de hotel, comparar OTAs o encontrar habitaciones.
- [Pricewin Booking Assistant](https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-booking-assistant.md): Recomienda habitaciones y completa una reserva real de principio a fin en OpenTravel direct: enlace de pago (QR, tarjeta o PayPal), estado del pago, reenvío o cancelación. Para hoteles solo-OTA, da el enlace directo.
- [Pricewin Flight Search](https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-flight-search.md): Busca tarifas de vuelo en vivo por ruta y fecha en Agoda, Trip.com y Traveloka, ida o ida y vuelta, con aerolínea, horarios, escalas, duración y enlace directo de reserva. Para precios de vuelos o comparar aerolíneas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)