pricewin-hotel-searchlisted
Install: claude install-skill Price-Win/pricewin-skills-hub
> **Requires the `pricewin` MCP server.** This skill is documentation only — no
> code, no dependencies, no install hook, and no network calls of its own. It
> reads results from a **hosted backend operated by PriceWin**
> (`https://mcp.price.win/mcp`, no credentials, no account) whose server code is
> **closed-source**. It sends a travel query only — city, dates, guests — and no
> personal data. Details in [`SECURITY.md`](./SECURITY.md); if you want no hosted
> backend at all, use the standalone
> [`pricewin-hotel-deal-finder`](../pricewin-hotel-deal-finder/) instead.
# Hotel Search (Live)
**MCP server:** `pricewin`. Tool `search_hotels_live` triggers async crawl across 3 OTAs.
## CRITICAL: Polling pattern
`search_hotels_live` returns IMMEDIATELY with sessionId. **You MUST poll until results arrive:**
1. Call `search_hotels_live` with city, checkIn (YYYY-MM-DD), checkOut (YYYY-MM-DD), adults, language="vi"
2. Wait 5s, then `poll_search_results(sessionId, nights)`
3. If status == "pending" or "partial": **wait 5s and poll AGAIN — up to 18 times (90s total)**
4. Present results as soon as status == "partial" with hotels
5. Continue polling silently — refine if more arrive
**Never tell the user "loading/please wait" after 1-2 polls — that's premature.**
## 4th source: OpenTravel
Pricewin returns a 4th source — `opentravelResults` — alongside Agoda/Booking/Traveloka. OpenTravel is an independent OTA, ranked the same way as the others: **purely on price, no priority**.
F