pricewin-booking-assistant

by price-win · part of price-win/pricewin-skills-hub

Recommend hotels and rooms, generate direct OTA booking links for Agoda and Booking.com. Use when booking a hotel, getting room recommendations, or generating booking links.

🧩 One of 5 skills in the price-win/pricewin-skills-hub package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Booking Assistant

Server: pricewin MCP. Orchestrates search → compare → recommend workflow across Agoda + Booking.com.

Recommendation Algorithm

Search: search_hotels with city + guest count + budget filters
Score: rating × log(reviewCount + 1) — balances quality with credibility
Rank: top 3-5 hotels by score
Compare: compare_hotel_prices for each shortlisted hotel
Recommend: filter rooms by guest capacity → pick best value

Booking Link Rules

NEVER invent URLs — only use url from providers[] or room data
Links go directly to OTA (Agoda/Booking.com) booking pages
Always show the OTA source name alongside the link
If multiple OTAs have the same room, show both with prices

Multi-Hotel Comparison

When user wants to compare across hotels:

search_hotels with filters → get top candidates
compare_hotel_prices for each (parallel if possible)
Present side-by-side: hotel name, best room price, cancellation, rating

Output Format

For each recommendation:

### Hotel Name ★★★★☆
- Rating: 8.5/10 (1,234 reviews)
- Best room: Deluxe Double — $85/night
- Free cancellation: Yes
- Book: [Agoda](https://github.com/Price-Win/pricewin-skills-hub/blob/main/skills/pricewin-booking-assistant/url) | [Booking.com](https://github.com/Price-Win/pricewin-skills-hub/blob/main/skills/pricewin-booking-assistant/url)

Key Parameters

Tool	When to Use
`search_hotels`	Initial discovery with filters
`get_hotel_details`	Deep dive on a specific hotel
`compare_hotel_prices`	Date-specific price comparison
`get_popular_hotels`	Quick recommendations without filters
`autocomplete_city`	Resolve city name to slug

Payload shapes: reference.md.

Copy & paste — that's it

npx skills add https://github.com/price-win/pricewin-skills-hub --skill pricewin-booking-assistant

Run this in your project — your agent picks the skill up automatically.