TravelHound

SKILL.md

# TravelHound

> Flight and hotel price comparison with booking timing analysis, OTA coupon stacking, and destination intelligence — all in one skill.

TravelHound combines real-time price data from Google Flights, Skyscanner, Kayak, Booking.com, Agoda, and Trip.com with coupon stacking via CouponClaw and destination news via NewsToday. It tells you not just the cheapest option, but whether now is the right time to book.

## What TravelHound does

- **Flight comparison**: Google Flights + Skyscanner + Kayak + Trip.com, with Kayak's "Buy now vs Wait" forecast
- **Hotel comparison**: Booking.com + Agoda + Hotels.com + Trip.com, with OTA coupon stacking
- **Full trip planner**: Flights + hotels in one output with total budget estimate
- **Destination intelligence**: Visa requirements, exchange rate trend, safety advisories, latest news
- **Booking timing**: Price history analysis to decide whether to book now or wait

## Trigger phrases

- "cheap flights to..."
- "flights from X to Y"
- "机票"
- "查机票"
- "hotel in..."
- "酒店"
- "查酒店"
- "trip to..."
- "travel to..."
- "旅行计划"
- "全程规划"
- "去X旅游"
- "订酒店"
- "best time to book"
- "should I book now"

## Scripts

| Script | Command | Description |
|---|---|---|
| `flights.js` | `node scripts/flights.js <from> <to> [--date YYYY-MM-DD] [--return YYYY-MM-DD] [--class economy\|business] [--passengers N] [--lang zh\|en]` | Flight price comparison across 4 platforms with booking timing advice |
| `hotels.js` | `node scripts/hotels.js <destination> [--checkin YYYY-MM-DD] [--checkout YYYY-MM-DD] [--guests N] [--budget budget\|mid\|luxury] [--lang zh\|en]` | Hotel price comparison with OTA coupon stacking |
| `trip.js` | `node scripts/trip.js <destination> [--from city] [--date YYYY-MM-DD] [--nights N] [--budget budget\|mid\|luxury] [--lang zh\|en]` | Full trip planner: flights + hotels + destination intel in one report |

## Data sources

| Platform | Type | Strength |
|---|---|---|
| Google Flights | Flights | Best aggregator; date flexibility view; price insights |
| Skyscanner | Flights | Lowest fares including budget carriers; "Everywhere" flexible origin |
| Kayak | Flights + Hotels | Price Forecast (Buy now / Wait); price history chart |
| Trip.com / 携程 | Flights + Hotels | Often cheapest for Asian routes; Chinese carrier coverage |
| Booking.com | Hotels | Widest inventory globally; Genius member discounts |
| Agoda | Hotels | Best rates for Southeast and East Asia |
| Hotels.com | Hotels | 10-night loyalty program |

## Ecosystem integration

TravelHound calls:
- **CouponClaw** — finds promo codes for Booking.com, Agoda, Trip.com, and Skyscanner on top of platform prices
- **NewsToday** — pulls destination-relevant news (political situation, weather events, local festivals)

## No API required

TravelHound uses browser navigation to read live pricing from each platform. No API keys or subscriptions needed.