name: google-flights description: Search Google Flights for prices and availability. Use when user asks about flight prices, searching for flights, comparing airfares, or planning air travel between cities.

Flights

Two modes: quick (prices only, fast) and full (airlines/times/stops, browser).

Quick Mode (Default)

Use scripts/search.py for fast price lookups:

./scripts/search.py YYC LAX "2026-03-15"
./scripts/search.py YYC LAX tomorrow --return "next friday"
./scripts/search.py JFK LHR "Mar 1" --adults 2 --seat business

Output: Price trend (low/typical/high), price range, flight count, Google Flights link.

Options:

• --return, -r — Return date for round-trip
• --adults, -a — Number of adults (default: 1)
• --children, -c — Number of children
• --seat, -s — economy, premium-economy, business, first
• --json — JSON output

Full Mode (Browser)

When user needs airlines, times, or specific flight options — use browser automation:

1. browser open (profile: clawd, targetUrl: google flights URL)
2. browser snapshot (wait for "results returned" alert)
3. Parse link descriptions for flight data
4. browser close

URL Format

# One-way
https://www.google.com/travel/flights?q=Flights%20from%20{FROM}%20to%20{TO}%20on%20{DATE}%20one%20way&hl=en

# Round-trip
https://www.google.com/travel/flights?q=Flights%20from%20{FROM}%20to%20{TO}%20on%20{DATE}%20returning%20{RETURN}&hl=en

Parsing Snapshot

Flight data in link elements:

"From 737 Canadian dollars... flight with Air Canada. Leaves... at 6:25 AM... arrives at 11:48 AM... Total duration 6 hr 23 min. 1 stop... Layover 1 hr 30 min at YVR..."

Full Mode Output

✈️ YYC → LAX | Fri Feb 20

1. Air Canada | 6:25 AM → 11:48 AM | 6h 23m | 1 stop (YVR) | CA$737
2. United | 6:15 AM → 11:31 AM | 6h 16m | 1 stop (DEN) | CA$744
3. WestJet | 9:00 AM → 11:27 AM | 3h 27m | Nonstop | CA$1,047 ⭐

🔗 Book on Google Flights: [link]

Setup (Quick Mode)

Quick mode requires fast-flights. Install once:

cd skills/google-flights
uv venv && source .venv/bin/activate && uv pip install fast-flights

When to Use Which