# Google Flights

> Google Flights

- Skill: `spike-faye-lei/google-flights` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/google-flights`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/google-flights/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/google-flights

---

# Google Flights

## Overview
Flight search and pricing — adapter-based DOM extraction from rendered Google Flights pages.

## Workflows

### Search flights on a route
1. `searchFlights(tfs)` → `flights[]` with airline, times, price, stops, duration

### Explore destinations from an origin
1. `exploreDestinations()` → `destinations[]` with flightPrice, dates, stops
2. Build `tfs` for a chosen destination → `searchFlights(tfs)` for specific flights

### Compare search results with price insights
1. `searchFlights(tfs)` → current flight options and prices
2. `getPriceInsights(tfs)` → cheapest/most expensive months, price trend, popular airlines
3. `getFlightOverview(tfs)` → cheapest fares and fastest nonstop for the route

All `tfs`-based operations share the same encoded route parameter (from the Google Flights URL).

### Get booking details for a specific itinerary
1. `searchFlights(tfs)` → pick a flight
2. `getFlightBookingDetails(tfs)` → leg details, baggage policies, booking links

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| searchFlights | search flights by route and dates | tfs (encoded route+dates) | origin, destination, flights[].airline, price, stops, duration | entry point; verified |
| getFlightOverview | cheapest fares and fastest flight for a route | tfs (encoded route) | cheapestOptions[].price, airline, fastestFlight, nonstopFrequency | entry point; same tfs |
| getFlightBookingDetails | itinerary details with baggage | tfs (encoded itinerary) | totalPrice, legs[].airline, duration, bagPolicies, bookWith | entry point; same tfs |
| exploreDestinations | browse destinations by budget from origin | — (optional tfs) | destinations[].destination, flightPrice, hotelPricePerNight, dates | entry point |
| getPriceInsights | monthly price trends and predictions | tfs (encoded route) | priceTrend, cheapestMonth, mostExpensiveMonth, popularAirlines | entry point; same tfs |

## Quick Start

```bash
# Search flights RDU → LGA (tfs from Google Flights URL)
openweb google-flights exec searchFlights '{"tfs":"CBwQAhopEgoyMDI2LTA0LTMwagwIAhIIL20vMGZ2eWdyDQgDEgkvbS8wMl8yODYaKRIKMjAyNi0wNS0wNGoNCAMSCS9tLzAyXzI4NnIMCAISCC9tLzBmdnlnQAFIAXABggELCP___________wGYAQE"}'

# Explore destinations (default origin)
openweb google-flights exec exploreDestinations '{}'

# Price insights for a route
openweb google-flights exec getPriceInsights '{"tfs":"CBwQAhopEgoyMDI2LTA0LTMwagwIAhIIL20vMGZ2eWdyDQgDEgkvbS8wMl8yODYaKRIKMjAyNi0wNS0wNGoNCAMSCS9tLzAyXzI4NnIMCAISCC9tLzBmdnlnQAFIAXABggELCP___________wGYAQE"}'
```