- name
- google-flights
- description
- Search Google Flights for prices, availability, and deals. Use when user asks about flight prices, searching for flights, comparing airfares, finding the cheapest travel dates, or monitoring prices on regular routes. Supports flexible date search, filters (nonstop, price cap, departure/arrival times), connection quality scoring, and price tracking with alerts.
Google Flights
Flight search with flexible dates, smart filters, connection scoring, and price tracking.
Quick Start
cd ~/clawd/skills/google-flights
source .venv/bin/activate
# Basic search
./scripts/search.py LAX JFK tomorrow
# Flexible dates — find cheapest day
./scripts/search.py LAX JFK "apr 15" --flex 3
# Nonstop under $500
./scripts/search.py SFO ORD "next friday" --nonstop --max-price 500
# Watch a route for price drops
./scripts/watch-route.py add LAX JFK --alert-below 350
./scripts/watch-route.py watchSearch
Basic Usage
./scripts/search.py <from> <to> <date> [options]Date Formats
Natural language supported:
tomorrow,todaynext friday,next weekmar 15,March 15,3/152026-04-15(ISO format)
Filters
| Flag | Short | Description |
|---|---|---|
--flex N | -f | Search ±N days around date |
--nonstop | -n | Nonstop flights only |
--max-price | -m | Maximum price |
--depart-after | Depart after time (8am, 14:00) | |
--arrive-before | Arrive before time (6pm, 18:00) | |
--seat | -s | economy, premium-economy, business, first |
--adults | -a | Number of adults (default: 1) |
--children | -c | Number of children |
--return | -r | Return date for round-trip |
Output
| Flag | Description |
|---|---|
--top N | Show top N results (default: 5) |
--sort | Sort by: price (default), score, duration |
--show-scores | Show connection quality breakdown |
--json | JSON output |
Examples
# Find cheapest day in a week window
./scripts/search.py LAX JFK "apr 10" --flex 7 --nonstop
# Morning departure, business class
./scripts/search.py SFO LHR "may 1" --seat business --depart-after 8am
# Family trip sorted by connection quality
./scripts/search.py DEN MCO "jun 15" -a 2 -c 2 --sort score --show-scores
# Round-trip under $800
./scripts/search.py SEA LAX "apr 1" --return "apr 8" --max-price 800Price Tracking
Track specific flights and get alerts on price changes.
# Track a specific flight
./scripts/track.py add LAX JFK "2026-05-15" --alert-below 400
# Track round-trip
./scripts/track.py add LAX JFK "may 1" --return "may 8" -a 350
# Check all tracked flights
./scripts/track.py check
# View price history
./scripts/track.py history LAX-JFK-2026-05-15
# List / remove
./scripts/track.py list
./scripts/track.py remove LAX-JFK-2026-05-15Route Watching
Monitor regular routes (e.g., commute between two cities).
# Add a route to watch
./scripts/watch-route.py add LAX JFK --alert-below 400
# Check all watched routes
./scripts/watch-route.py watch
# List watched routes
./scripts/watch-route.py list
# Remove a route
./scripts/watch-route.py remove LAX-JFKCron Integration
Set up daily price checks:
openclaw cron add \
--name "Flight Price Watch" \
--cron "0 9 * * *" \
--tz "America/New_York" \
--session isolated \
--message "cd ~/clawd/skills/google-flights && source .venv/bin/activate && ./scripts/watch-route.py watch. Alert user only if prices drop below threshold."Connection Quality Scoring
Flights scored 0-100 based on:
| Factor | Impact |
|---|---|
| Nonstop flight | +15 |
| Preferred airline | +10 |
| Tight connection (<45min) | -30 |
| Long layover (>4hr) | -5 to -25 |
| Problematic connection airport | -10 to -20 |
| Winter weather risk (ORD, EWR, etc.) | -15 |
| Red-eye (depart after 10pm) | -15 |
| Early departure (<6am) | -10 |
| Avoided airline | -25 |
Use --show-scores to see breakdown or --sort score to prioritize quality.
Configuration
Copy config.example.json to config.json and customize:
{
"preferred_airlines": ["United", "Delta"],
"avoid_airlines": ["Spirit"],
"prefer_nonstop": true,
"max_layover_hours": 4,
"min_layover_minutes": 45,
"home_airports": ["LAX", "JFK"],
"loyalty_programs": {
"united_mileageplus": "gold"
}
}Setup
cd ~/clawd/skills/google-flights
uv venv && source .venv/bin/activate && uv pip install fast-flights
chmod +x scripts/*.py
cp config.example.json config.json # then editData Files
~/clawd/memory/flight-tracking.json— Tracked flights~/clawd/memory/flight-prices.jsonl— Price history~/clawd/memory/route-watch-state.json— Watched routes