google-flights · imoonkey — Claude Code skill: what it does, how to install

# 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"}'
```