Flight Search
Search real-time flight schedules and prices via Google Flights data.
Prerequisites
pip install fast-flights
The flights-search CLI is bundled at scripts/flights-search in this skill directory.
CLI Usage
flights-search <origin> <destination> <date> [options]
Origin and destination accept IATA codes (JFK, LAX) or city names (NYC, London, Tokyo). City names automatically search all airports in that metro area.
Examples
# Search all NYC airports to LAX
flights-search NYC LAX 2026-03-15
# Nonstop flights from NYC to Berlin
flights-search NYC Berlin 2026-03-15 --nonstop
# Evening departures only
flights-search JFK LHR 2026-03-15 --after 17 --before 22
# Business class
flights-search NYC London 2026-03-15 --class business
# Multiple passengers with booking link
flights-search SF Tokyo 2026-04-01 --passengers 2 --link
Options
| Option |
Description |
--nonstop |
Nonstop flights only |
--all-stops |
Show all flights regardless of stops |
--after HH |
Depart after hour (24h format) |
--before HH |
Depart before hour (24h format) |
--class |
Cabin: economy, premium, business, first |
--passengers N |
Number of travelers (default: 1) |
--link |
Print Google Flights URL |
Supported City Names
When you use a city name, the CLI searches all airports in that metro area:
| City |
Airports |
| NYC / New York |
JFK, EWR, LGA |
| LA / Los Angeles |
LAX, BUR, LGB, ONT, SNA |
| SF / San Francisco |
SFO, OAK, SJC |
| Chicago |
ORD, MDW |
| DC / Washington |
DCA, IAD, BWI |
| London |
LHR, LGW, STN, LTN, LCY |
| Paris |
CDG, ORY |
| Tokyo |
NRT, HND |
| Toronto |
YYZ, YTZ |
60+ metro areas supported. Use any IATA code directly for airports not in the list.
Default Behavior
By default, the CLI shows only flights with the minimum stops available:
- If nonstops exist → shows only nonstops
- If no nonstops → shows only 1-stop flights
- Use
--all-stops to see everything
Output
Searching from NYC: JFK, EWR, LGA
Route Depart Arrive Airline Price Duration
------------------------------------------------------------------------------------------------------------
EWR→LAX 6:00 AM on Sat, Mar 7 9:07 AM on Sat, Mar 7 United $289 6 hr 7 min
EWR→LAX 12:00 PM on Sat, Mar 7 3:14 PM on Sat, Mar 7 United $289 6 hr 14 min
JFK→LAX 8:00 AM on Sat, Mar 7 11:30 AM on Sat, Mar 7 Delta $304 5 hr 30 min
3 flight(s) found.
Notes
- Date format:
YYYY-MM-DD
- Airport codes: Standard IATA codes (JFK, LAX, LHR, etc.)
- Prices are in USD
- Times shown in local airport timezone
- No API key required — uses Google Flights data via reverse-engineered protobuf API
- Some routes may return price-only results (missing departure/arrival times) due to upstream parsing limitations
Data Source
Uses Google Flights data via the fast-flights Python package.
1---2name: flights3description: Search flights via Google Flights. Find nonstop/connecting flights, filter by time and cabin class, get booking links. Supports city names (NYC, London, Tokyo) with automatic multi-airport search. No API key required.4---56# Flight Search78Search real-time flight schedules and prices via Google Flights data.910## Prerequisites1112```bash13pip install fast-flights14```1516The `flights-search` CLI is bundled at `scripts/flights-search` in this skill directory.1718## CLI Usage1920```bash21flights-search <origin> <destination> <date> [options]22```2324Origin and destination accept **IATA codes** (JFK, LAX) or **city names** (NYC, London, Tokyo). City names automatically search all airports in that metro area.2526### Examples2728```bash29# Search all NYC airports to LAX30flights-search NYC LAX 2026-03-153132# Nonstop flights from NYC to Berlin33flights-search NYC Berlin 2026-03-15 --nonstop3435# Evening departures only36flights-search JFK LHR 2026-03-15 --after 17 --before 223738# Business class39flights-search NYC London 2026-03-15 --class business4041# Multiple passengers with booking link42flights-search SF Tokyo 2026-04-01 --passengers 2 --link43```4445### Options4647| Option | Description |48|--------|-------------|49| `--nonstop` | Nonstop flights only |50| `--all-stops` | Show all flights regardless of stops |51| `--after HH` | Depart after hour (24h format) |52| `--before HH` | Depart before hour (24h format) |53| `--class` | Cabin: economy, premium, business, first |54| `--passengers N` | Number of travelers (default: 1) |55| `--link` | Print Google Flights URL |5657### Supported City Names5859When you use a city name, the CLI searches all airports in that metro area:6061| City | Airports |62|------|----------|63| NYC / New York | JFK, EWR, LGA |64| LA / Los Angeles | LAX, BUR, LGB, ONT, SNA |65| SF / San Francisco | SFO, OAK, SJC |66| Chicago | ORD, MDW |67| DC / Washington | DCA, IAD, BWI |68| London | LHR, LGW, STN, LTN, LCY |69| Paris | CDG, ORY |70| Tokyo | NRT, HND |71| Toronto | YYZ, YTZ |727360+ metro areas supported. Use any IATA code directly for airports not in the list.7475## Default Behavior7677By default, the CLI shows only flights with the **minimum stops available**:78- If nonstops exist → shows only nonstops79- If no nonstops → shows only 1-stop flights80- Use `--all-stops` to see everything8182## Output8384```85Searching from NYC: JFK, EWR, LGA8687Route Depart Arrive Airline Price Duration88------------------------------------------------------------------------------------------------------------89EWR→LAX 6:00 AM on Sat, Mar 7 9:07 AM on Sat, Mar 7 United $289 6 hr 7 min90EWR→LAX 12:00 PM on Sat, Mar 7 3:14 PM on Sat, Mar 7 United $289 6 hr 14 min91JFK→LAX 8:00 AM on Sat, Mar 7 11:30 AM on Sat, Mar 7 Delta $304 5 hr 30 min92933 flight(s) found.94```9596## Notes9798- Date format: `YYYY-MM-DD`99- Airport codes: Standard IATA codes (JFK, LAX, LHR, etc.)100- Prices are in USD101- Times shown in local airport timezone102- No API key required — uses Google Flights data via reverse-engineered protobuf API103- Some routes may return price-only results (missing departure/arrival times) due to upstream parsing limitations104105## Data Source106107Uses Google Flights data via the [`fast-flights`](https://github.com/AWeirdDev/flights) Python package.
johnalbertini14-glitch