{"skill":{"slug":"flights-search","displayName":"Flights","summary":"Search flights via Google Flights. Find nonstop/connecting flights, filter by time and cabin class, get booking links. Supports city names (NYC, London, Toky...","description":"---\nname: flights\nversion: 1.2.0\ndescription: 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.\n---\n\n# Flight Search\n\nSearch real-time flight schedules and prices via Google Flights data.\n\n## Prerequisites\n\n- **Python 3.9+**\n- **[uv](https://docs.astral.sh/uv/)** (recommended) — install with `curl -LsSf https://astral.sh/uv/install.sh | sh`\n\nThe `flights-search` CLI is bundled at `scripts/flights-search` in this skill directory.\n\nThe `fast-flights` library is installed automatically on first run via `uvx` (cached after that). Or install manually: `pip install fast-flights`\n\n## CLI Usage\n\n```bash\nuvx --with fast-flights python3 scripts/flights-search <origin> <destination> <date> [options]\n```\n\nOrigin and destination accept **IATA codes** (JFK, LAX) or **city names** (NYC, London, Tokyo). City names automatically search all airports in that metro area.\n\n### Examples\n\n```bash\n# Search all NYC airports to LAX\nflights-search NYC LAX 2026-03-15\n\n# Nonstop flights from NYC to Berlin\nflights-search NYC Berlin 2026-03-15 --nonstop\n\n# Evening departures only\nflights-search JFK LHR 2026-03-15 --after 17 --before 22\n\n# Business class\nflights-search NYC London 2026-03-15 --class business\n\n# Multiple passengers with booking link\nflights-search SF Tokyo 2026-04-01 --passengers 2 --link\n```\n\n### Options\n\n| Option | Description |\n|--------|-------------|\n| `--nonstop` | Nonstop flights only |\n| `--all-stops` | Show all flights regardless of stops |\n| `--after HH` | Depart after hour (24h format) |\n| `--before HH` | Depart before hour (24h format) |\n| `--class` | Cabin: economy, premium, business, first |\n| `--passengers N` | Number of travelers (default: 1) |\n| `--link` | Print Google Flights URL |\n\n### Supported City Names\n\nWhen you use a city name, the CLI searches all airports in that metro area:\n\n| City | Airports |\n|------|----------|\n| NYC / New York | JFK, EWR, LGA |\n| LA / Los Angeles | LAX, BUR, LGB, ONT, SNA |\n| SF / San Francisco | SFO, OAK, SJC |\n| Chicago | ORD, MDW |\n| DC / Washington | DCA, IAD, BWI |\n| London | LHR, LGW, STN, LTN, LCY |\n| Paris | CDG, ORY |\n| Tokyo | NRT, HND |\n| Toronto | YYZ, YTZ |\n\n60+ metro areas supported. Use any IATA code directly for airports not in the list.\n\n## Default Behavior\n\nBy default, the CLI shows only flights with the **minimum stops available**:\n- If nonstops exist → shows only nonstops\n- If no nonstops → shows only 1-stop flights\n- Use `--all-stops` to see everything\n\n## Output\n\n```\nSearching from NYC: JFK, EWR, LGA\n\nRoute        Depart                       Arrive                       Airline          Price       Duration\n------------------------------------------------------------------------------------------------------------\nEWR→LAX      6:00 AM on Sat, Mar 7        9:07 AM on Sat, Mar 7        United           $289        6 hr 7 min\nEWR→LAX      12:00 PM on Sat, Mar 7       3:14 PM on Sat, Mar 7        United           $289        6 hr 14 min\nJFK→LAX      8:00 AM on Sat, Mar 7        11:30 AM on Sat, Mar 7       Delta            $304        5 hr 30 min\n\n3 flight(s) found.\n```\n\n## Notes\n\n- Date format: `YYYY-MM-DD`\n- Airport codes: Standard IATA codes (JFK, LAX, LHR, etc.)\n- Prices are in USD\n- Times shown in local airport timezone\n- No API key required — uses Google Flights data via reverse-engineered protobuf API\n- Some routes may return price-only results (missing departure/arrival times) due to upstream parsing limitations\n\n## Data Source\n\nUses Google Flights data via the [`fast-flights`](https://github.com/AWeirdDev/flights) Python package.\n","tags":{"latest":"1.2.0"},"stats":{"comments":0,"downloads":3264,"installsAllTime":4,"installsCurrent":4,"stars":2,"versions":3},"createdAt":1770180510885,"updatedAt":1778988177145},"latestVersion":{"version":"1.2.0","createdAt":1772048794036,"changelog":"uvx prereqs, airline booking links, metro area mapping","license":null},"metadata":null,"owner":{"handle":"brennerspear","userId":"s17ebpr0c7y6bpmzatrjw5rdt583fggy","displayName":"BrennerSpear","image":"https://avatars.githubusercontent.com/u/12127609?v=4"},"moderation":null}