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 watch

Search

Basic Usage

./scripts/search.py <from> <to> <date> [options]

Date Formats

Natural language supported: - tomorrow, today - next friday, next week - mar 15, March 15, 3/15 - 2026-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 800

Price 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-15

Route 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-JFK

Cron 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 edit

Data Files

~/clawd/memory/flight-tracking.json — Tracked flights
~/clawd/memory/flight-prices.jsonl — Price history
~/clawd/memory/route-watch-state.json — Watched routes