google-flights

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