pricewin-price-comparison
Compare live hotel room rates across Booking.com, Agoda, Traveloka, and OpenTravel for specific dates — which OTA is cheapest for the same p
Open source Repository Open in the app JSON README (API)
About
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.
Details
- Kind
- Agent skills
- Topic
- Maps, weather & travel
- Publisher
- price-win
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 1
- Forks
- 1
- Last push
- 2026-08-09T11:48:02Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT-0
- Added
- 2026-08-30 15:21:15
- Updated
- 2026-09-11 16:02:08
- Origin id
price-win/pricewin-skills-hub/pricewin-price-comparison
README
# Pricewin Skills Hub
**Find the cheapest hotel deal in one command.** AI-agent skills that compare
**live** prices across Booking.com, Agoda, Google Hotels & OpenTravel and hand
back ranked best-value / cheapest / quality picks with direct booking links.
> ⭐ **Most popular skill: [`pricewin-hotel-deal-finder`](https://www.skills.sh/price-win/pricewin-skills-hub/pricewin-hotel-deal-finder)** — standalone, no MCP server, no API keys.
>
> ```bash
> npx skills add https://github.com/Price-Win/pricewin-skills-hub --skill pricewin-hotel-deal-finder
> ```
```
🏨 Tokyo • Aug 12–15 • 3 nights • 2 guests
━━━━━━━━━━━━━━━━━━━━
🥇 BEST VALUE Shinjuku Granbell Hotel ✅ agoda $118 · booking $131 → save $13
🥈 CHEAPEST APA Hotel Shinjuku ✅ google $94
📊 18 hotels | agoda, booking, google, opentravel • prices in USD
```
Why people install it:
- 🥇🥈🥉 best-value / cheapest / quality picks, side by side
- 4 sources, all normalized to **USD**, with clickable links to the cheapest OTA
- Works for **any city worldwide** — even bot-hardened ones (Shanghai, Hangzhou, Bangkok) via a stealth Patchright daemon
- No MCP server, no API keys — just `node` + `npx`
---
Skills for AI agents to search hotels, compare OTA prices, and surface the best
booking deals. Two families:
- **MCP skills** — drive the Pricewin MCP server (`pricewin`).
- **Standalone skill** — `pricewin-hotel-deal-finder` runs its own browser + API stack,
no MCP server required.
**Repo:** `git@github.com:Price-Win/pricewin-skills-hub.git`
## Skills
| Skill | Type | Trigger | Sources / Tools |
|-------|------|---------|-----------------|
| `pricewin-hotel-search` | MCP | search/find hotels live for travel dates | `search_hotels_live` → `poll_search_results` (Agoda + Booking.com + Traveloka, plus `opentravelResults` OpenTravel listings) |
| `pricewin-price-comparison` | MCP | compare prices, check room rates for a named hotel | `search_hotels_live` → `poll_search_results`, `get_ota_hotel_detail`, `get_hotel_detail`, `get_cancellation_policy` |
| `pricewin-booking-assistant` | MCP | recommend room, book + pay, manage a reservation | `get_hotel_detail` → `create_booking`, `check_booking_status`, `recreate_payment_link`, `request_cancel_token` → `cancel_booking` |
| `pricewin-hotel-deal-finder` | Standalone | hotel deals / price comparison for travel dates | Browser automation (Patchright) over Booking.com + Agoda + Google Hotels, plus the **OpenTravel** public API — no MCP server |
## `pricewin-hotel-deal-finder` (standalone)
Self-contained skill: a long-running Patchright (stealth Chromium) daemon scrapes
Booking.com, Agoda, and Google Hotels, while a single HTTPS call hits the
OpenTravel public API. One command does everything:
```bash
node bin/search.js "<city>" <checkIn YYYY-MM-DD> <checkOut YYYY-MM-DD> <adults> en-us
```
- **OpenTravel API base:** `https://api.opentravel.one`
(override with `OPENTRAVEL_API_BASE_URL`)
- **Setup:** `skills/pricewin-hotel-deal-finder/install.sh` (Node deps + Chromium, ~200MB one-time)
- **Cache:** `~/.cache/pricewin-hotel-deal-finder/selectors.json`
See `skills/pricewin-hotel-deal-finder/SKILL.md` for full usage and rules.
**Roadmap:** hotels and **flights** ship today (flights via `skills/pricewin-flight-search/`, MCP-driven); **rental-car** price comparison is on the way — the same one-command, multi-source, USD-normalized deal-finding, extended across your whole trip. (Powered by [PriceWin](https://price.win) — *tìm giá tốt nhất* across 50+ travel platforms.)
### Install (agents)
The skill follows the [agentskills.io](https://agentskills.io) `SKILL.md` standard and
publishes to both ecosystems. `node_modules` and Chromium are **not** bundled — the
install hook fetches them on first install (needs network + `node`/`npx` on PATH).
```bash
# OpenClaw / ClawHub
clawhub skill publish ./skills/pricewin-hotel-deal-finder \
--slug pricewin-hotel-deal-finder --name "PriceWin Hotel Deal Finder" --version 0.7.0 --tags travel,hotel
openclaw skills install pricewin-hotel-deal-finder # users / agents
# Hermes — install straight from this repo (github: source pulls the whole dir)
hermes skills install github:Price-Win/pricewin-skills-hub/skills/pricewin-hotel-deal-finder
# Manual / dev
git clone git@github.com:Price-Win/pricewin-skills-hub.git
cd pricewin-skills-hub/skills/pricewin-hotel-deal-finder && ./install.sh
```
## Security & data handling
Every skill ships a `SECURITY.md` next to its `SKILL.md` — what it executes, what
leaves the machine, and who operates the backend:
| Skill | Runs code? | Data it sends | Disclosure |
|---|---|---|---|
| `pricewin-hotel-deal-finder` | Yes — local Patchright daemon | search query only (city, dates, guests) | [SECURITY.md](skills/pricewin-hotel-deal-finder/SECURITY.md) |
| `pricewin-hotel-search` | No | search query | [SECURITY.md](skills/pricewin-hotel-search/SECURITY.md) |
| `pricewin-price-comparison` | No | search query + `queryText` | [SECURITY.md](skills/pricewin-price-comparison/SECURITY.md) |
| `pricewin-flight-search` | `install.sh` only (MCP registration) | route + dates | [SECURITY.md](skills/pricewin-flight-search/SECURITY.md) |
| `pricewin-booking-assistant` | No | **guest PII** (name, phone, email) — real bookings | [SECURITY.md](skills/pricewin-booking-assistant/SECURITY.md) |
The deal-finder's local daemon is loopback-only, token-authenticated (`0600`
state file), rejects non-loopback `Host` headers, and keeps the Chromium sandbox
on. No skill ever handles card numbers: payment happens on the provider's page.
Privacy policy: <https://price.win/en/privacy-policy>.
## FAQ
**Is Booking.com or Agoda cheaper?** Neither wins universally — it depends on the hotel, dates, and region. Independent tests (CNBC's review of ~200,000 hotel searches) found **Agoda had the lowest rate about 34% of the time** globally, and it tends to win in **Asia-Pacific** while **Booking.com pulls ahead more often in Europe**. That is exactly why `pricewin-hotel-deal-finder` queries **both** (plus Google Hotels and OpenTravel) in a single run, shows the per-night gap, labels the cheapest source per property, and links you straight to it — so you never have to guess.
**How many sources does it compare, and how fast?** Up to **4 sources** (Booking.com, Agoda, Google Hotels, OpenTravel), all normalized to **USD**. A cached city returns in **~30–60 seconds**; a brand-new city pays a one-time Agoda discovery cost of **2–4 minutes**, then joins the cache.
**Do I need API keys or an MCP server?** No. `pricewin-hotel-deal-finder` is standalone — `node` + `npx` is all it needs. The only external dependency is Chromium (~200 MB), fetched once by the install hook.
**Does it work for bot-hardened cities?** Yes. A stealth Patchright (stealth Chromium) daemon handles anti-bot detection, so cities like Shanghai, Hangzhou, and Bangkok resolve where vanilla scrapers get blocked.
**How are prices normalized?** Booking.com returns USD natively; Agoda, Google Hotels, and OpenTravel geo-lock to VND by IP and are converted via a live FX rate. Every price in the output is USD.
**What does one command return?** Ranked **best-value 🥇 · cheapest 🥈 · quality 🥉** picks, each hotel name a clickable link to its cheapest OTA, plus a "More good deals" list grouped by source and a USD footer of exactly which sources returned data.
> _Last verified: 2026-07-08 · reviewed quarterly._
## MCP skills — prerequisites
- Pricewin MCP server running (`pricewin-mcp`, stdio transport, auto-launched by Claude)
- Backend API accessible
```json
{
"mcpServers": {
"pricewin": {
"command": "node",
"args": ["/path/to/pricewin-mcp/dist/index.js"]
}
}
}
```