# Pricewin Flight Search

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

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

Repositorio: https://github.com/Price-Win/pricewin-skills-hub
Autor: Price-Win
Licencia: MIT-0
Actualizado: hace 22 días
Coste de contexto: 92 tok instalada, 1.5k tok al activarse, 6.3k tok con todos los archivos del bundle
Bundle: 5 archivos, 24 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-flight-search --agent claude-code
# Cursor
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-flight-search --agent cursor
# Codex
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-flight-search --agent codex
# Gemini CLI
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-flight-search --agent gemini
# Windsurf
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-flight-search --agent windsurf
# Cline
npx -y skills add Price-Win/pricewin-skills-hub --skill pricewin-flight-search --agent cline
```

## Qué hace

- Busca tarifas de vuelo en vivo por ruta y fecha en Agoda, Trip.com y Traveloka, ida o ida y vuelta
- Sondea `search_flights_live`/`poll_flight_results` hasta obtener resultados y los presenta con aerolínea, horarios, escalas y duración
- Calcula el precio por persona a partir del total de la reserva y respeta la moneda que devuelve la herramienta
- Ordena los vuelos por precio, destacando el más barato

## Cuándo usarla

- Buscar precios de vuelos o billetes de avión entre dos ciudades
- Comparar aerolíneas para unas fechas de viaje
- Planear el tramo aéreo de un viaje

## Qué la activa

- "Busca vuelos baratos de Hanói a Bangkok para el 12 de agosto"
- "Compara tarifas de vuelo ida y vuelta entre SGN y NRT"
- "¿Cuál es el vuelo más barato para estas fechas?"

## Antes de instalar

- Necesita el servidor MCP `pricewin` registrado con `bash install.sh`, y reiniciar el agente después de instalarlo.

## Archivos

- SECURITY.md — 3 KB
- SKILL.md — 6 KB
- install.sh — 7 KB
- reference.md — 4 KB
- skill-card.md — 4 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.

## Setup (once per machine)

Without the MCP server registered this skill is inert — it tells you to call
`search_flights_live` and no such tool exists. `skills add` only copies files, so run:

```bash
bash install.sh          # add --dry-run first to see what it would change
```

It registers the hosted server (`https://mcp.price.win/mcp`, Streamable HTTP, no
credentials) with every agent it finds — Claude Code, Cursor, Windsurf, Gemini CLI, VS Code,
Codex — writing a `.bak` before touching any file and skipping configs it cannot parse.
Re-running it changes nothing. **Restart the agent afterwards.**

# Flight Search (Live)

**MCP server:** `pricewin`. Tool `search_flights_live` starts an async crawl across Agoda,
Trip.com and Traveloka; `poll_flight_results` returns the merged, cheapest-per-flight fares.

## CRITICAL: IATA codes only

Both airports MUST be 3-letter IATA codes. **There is no airport-lookup tool on this server** —
resolve the city yourself: `Sài Gòn / TP.HCM → SGN`, `Hà Nội → HAN`, `Đà Nẵng → DAD`,
`Bangkok → BKK` (main international), `Tokyo → NRT or HND`, `Seoul → ICN`.

When a city has several airports and the user did not say which, **ask one short question** —
never pick silently. Never invent a code.

## CRITICAL: Polling pattern (differs from hotel search)

`search_flights_live` returns IMMEDIATELY with a `sessionId` and zero flights.

1. Call `search_flights_live` with origin, destination, departureDate (YYYY-MM-DD), and
   `returnDate` only for a round trip. Add `adults`, `cabin`, `language="vi"` as needed.
2. Call `poll_flight_results(sessionId)`. **This tool blocks internally up to ~30s** and
   returns as soon as the first fares land — do NOT sleep before calling it.
3. `status` is `pending` | `searching` | `completed` | `failed`. If it comes back
   `searching` with few or no flights, **call again — up to 4 more times**.
4. Present results as soon as flights arrive; keep polling only if the user wants more.

The session expires **15 minutes** after the last poll. After that, start a new search —
the old `sessionId` is dead.

> `poll_flight_results` is registered app-visible for the flight widget. If your host does not
> expose it to the model, let the widget do the polling and do not fabricate fares.

## CRITICAL: `price` is the party total, in USD

`price` is the **total for all `adults`** — not per-person, and not the two legs combined.
Divide by `adults` yourself for a per-person figure.

`currency` is **`"USD"`**. Do not convert it. It falls back to `"VND"` only when the live FX
rate was unavailable — so **read `currency` and label the figure with it** rather than assuming
either one.

## Response format (MUST follow exactly)

Present the TOP 5-7 flights per leg ONLY. For EACH flight:

```
✈️ *<airline> <flightNumber>*  ← bold via markdown
🕐 <dep.time> <origin> → <arr.time> <destination> · <Xh Ym> · <bay thẳng | N điểm dừng>
💰 $<price> tổng cho <adults> khách (~$<price/adults>/khách)
🔗 <bookingUrl>
```

Line break between flights, no bullet markers. **Cheapest flight gets 🏆.** `duration` is in
**minutes** — format it as `2h 10m`. Flag an overnight arrival when `arrival.date` differs
from `departure.date`.

## Round trips

`outboundFlights` and `returnFlights` are **two independent one-way searches**. List them under
separate headings. You may state a combined estimate as
`cheapest outbound + cheapest return`, but label it as **two separate one-way tickets** — it is
not a quoted round-trip fare and the two legs are booked separately.

## Booking URLs — use verbatim

`bookingUrl` is the deep link of the cheapest agent, with dates and passengers already baked in.
**Never append, rewrite, or construct params** (unlike the hotel skill). A `bookingUrl` of exactly
`https://www.price.win/` means no agent deep link was captured — say the fare must be re-checked
on the provider's site instead of presenting it as a click-to-book link.

Attribute the source only from the URL host (`agoda.com`, `trip.com`, `traveloka.com`) — the
result carries no explicit source field, so do not guess one.

## Fields that look useful but are not

- `stopCities` — always empty; describe stops by count only
- `departure.city` / `arrival.city` — repeat the IATA code, not a real city name
- `legs` — usually absent on list results; don't promise a segment breakdown

## Ranking

Sort by `price`. Cheapest first, but surface a non-stop or much shorter option when it costs
only marginally more — say so in one line rather than reordering silently.

## Security & data handling

No runtime code and no network calls of its own; the only executable is
`install.sh`, which adds one MCP entry (`pricewin` → `https://mcp.price.win/mcp`)
to agent configs the user already has, backing each file up first and skipping
any it cannot parse. It downloads and executes nothing. The only data sent is the
route query (IATA codes, dates, passengers, cabin) — no passenger names, no PII,
no credentials. Comparison only: this skill cannot book or pay. Full disclosure
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 Price Comparison](https://skillsagentes.com/skills/price-win/pricewin-skills-hub/pricewin-price-comparison.md): 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.

---

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