What is the data source and do I need an API key?

The tool uses Google Flights data via the fast-flights reverse-engineered protobuf API. No API key is required.

What does the default behavior show?

By default the CLI shows only flights with the minimum stops. If nonstop options exist, those are shown; otherwise it shows 1-stop options. Use --all-stops to see every flight.

How do I get a booking link?

Add --link to print the Google Flights URL for the selected flight options, enabling quick booking.

Flights

Scanned

@BrennerSpear

npx machina-cli add skill @BrennerSpear/flights-search --openclaw

Files (1)

SKILL.md

2.7 KB

Flight Search

Search real-time flight schedules and prices via Google Flights data.

Prerequisites

pip install fast-flights

The flights-search CLI is installed at ~/.local/bin/flights-search.

CLI Usage

flights-search <origin> <destination> <date> [options]

Examples

# Basic search (auto-shows fewest stops available)
flights-search YYZ EWR 2026-02-06

# Nonstop flights only
flights-search YYZ JFK 2026-02-06 --nonstop

# Filter by departure time (24h format)
flights-search YYZ EWR 2026-02-06 --after 18        # After 6pm
flights-search YYZ EWR 2026-02-06 --before 12       # Before noon
flights-search YYZ EWR 2026-02-06 --after 9 --before 14

# Cabin class
flights-search YYZ EWR 2026-02-06 --class economy   # default
flights-search YYZ EWR 2026-02-06 --class premium   # premium economy
flights-search YYZ EWR 2026-02-06 --class business
flights-search YYZ EWR 2026-02-06 --class first

# Get Google Flights booking link
flights-search YYZ EWR 2026-02-06 --class business --link

# Multiple passengers
flights-search YYZ EWR 2026-02-06 --passengers 2

# Show all flights (ignore stop minimization)
flights-search YYZ EWR 2026-02-06 --all-stops

Options

Option	Description
`--nonstop`	Force nonstop 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
`--link`	Print Google Flights URL

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

Depart                       Arrive                       Airline         Price      Duration
----------------------------------------------------------------------------------------------------
6:00 PM Fri, Feb 6           7:38 PM Fri, Feb 6           Air Canada      $361       1 hr 38 min
9:10 PM Fri, Feb 6           10:48 PM Fri, Feb 6          Air Canada      $361       1 hr 38 min

2 nonstop flight(s) found.

Data Source

Uses Google Flights data via the fast-flights library (reverse-engineered protobuf API). No API key required.

Notes

Date format: YYYY-MM-DD
Airport codes: Standard IATA codes (JFK, LAX, YYZ, etc.)
Prices are in USD
Times shown in local airport timezone

Source

git clone https://clawhub.ai/BrennerSpear/flights-searchView on GitHub

Overview

This skill uses a CLI to search real-time flight schedules and prices from Google Flights. It supports finding nonstop and connecting flights, filtering by departure time and cabin class, adjusting passenger counts, and retrieving direct booking links when requested.

How This Skill Works

Use flights-search with origin, destination, and date, then apply options like --nonstop, --all-stops, --after, --before, --class, --passengers, and --link. The tool relies on the fast-flights library (reverse-engineered protobuf API) to pull Google Flights data without an API key, presenting results with times, airlines, prices, and durations.

When to Use It

Plan trips with specific departure windows or time-of-day preferences.
Compare nonstop flights vs connecting options when minimizing stops matters.
Generate a Google Flights booking URL for quick checkout (--link).
Organize group travel by setting the number of passengers (--passengers).
Explore all flight options beyond the default minimum-stops view (--all-stops).

Quick Start

Step 1: Install the CLI with pip install fast-flights.
Step 2: Run a basic search: flights-search <origin> <destination> <date>.
Step 3: Refine results with options like --nonstop, --after, --class, or --link to get a booking URL.

Best Practices

Use --after and --before to constrain departures to your preferred time window.
If you want every available option, include --all-stops instead of relying on default minimization.
Filter by cabin with --class to compare prices within the same cabin (economy, premium, business, first).
Use --link when you want a direct Google Flights booking URL for easy checkout.
Set --passengers to reflect your group size for accurate pricing.

Example Use Cases

flights-search YYZ EWR 2026-02-06
flights-search YYZ JFK 2026-02-06 --nonstop
flights-search YYZ EWR 2026-02-06 --after 18 --class business
flights-search YYZ EWR 2026-02-06 --link --class business
flights-search YYZ EWR 2026-02-06 --passengers 2

Frequently Asked Questions

Add this skill to your agents