mcpField
F
flight-search

flight-search

github.com/olafs-worldProductivity6166 installsUpdated 37w ago
Repository

About flight-search

flight-search is a command-line tool for searching Google Flights, aimed at people checking flight options. It needs no API key and can return structured JSON data.

Key features

  1. 01Search by airport codes
  2. 02Search one-way and round trips
  3. 03Set passenger count and cabin class
  4. 04Return structured JSON data

Use cases

  1. 01Compare prices and times across routes
  2. 02Find round trips for specified dates
  3. 03Pass flight results to data-processing workflows

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/olafs-world/flight-search --skill flight-search

After installing, type/flight-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
CHANGELOG.md
AGENTS.md
LICENSE
.python-version
README.md
pyproject.toml
pytest.ini
install.sh
uv.lock
.github/workflows/
ci.yml
flight_search/
search.py
__init__.py
cli.py
tests/
test_cli.py
__init__.py
test_search.py

Details

From the project README

Flight Search

Search Google Flights from the command line. Get prices, times, and airlines - no API key needed.

Built on fast-flights.

Quick Start

# one-off search (no install needed)
uvx flight-search DEN LAX --date 2026-03-01

# or install globally
uv tool install flight-search
flight-search JFK LHR --date 2026-06-15 --return 2026-06-22

Options

positional arguments:
  origin                Origin airport code (e.g., DEN, LAX, JFK)
  destination           Destination airport code

options:
  --date, -d            Departure date (YYYY-MM-DD) [required]
  --return, -r          Return date for round trips (YYYY-MM-DD)
  --adults, -a          Number of adults (default: 1)
  --children, -c        Number of children (default: 0)
  --class, -C           Seat class: economy, premium-economy, business, first
  --limit, -l           Max results (default: 10)
  --output, -o          Output format: text or json (default: text)

Examples

# One-way flight
flight-search DEN LAX --date 2026-03-01

# Round trip with passengers
flight-search JFK LHR --date 2026-06-15 --return 2026-06-22 --adults 2

# Business class
flight-search SFO NRT --date 2026-04-01 --class business

# JSON output for parsing
flight-search ORD CDG --date 2026-05-01 --output json

Example Output

✈️  DEN → LAX
   One way · 2026-03-01
   Prices are currently: typical

──────────────────────────────────────────────────
   Frontier ⭐ BEST
   🕐 10:43 PM → 12:30 AM +1
   ⏱️  2 hr 47 min
   ✅ Nonstop
   💰 $84

──────────────────────────────────────────────────
   United ⭐ BEST
   🕐 5:33 PM → 7:13 PM
   ⏱️  2 hr 40 min
   ✅ Nonstop
   💰 $139

JSON Output

Returns structured data:

{
  "origin": "DEN",
  "destination": "LAX",
  "date": "2026-03-01",
  "current_price": "typical",
  "flights": [
    {
      "airline": "Frontier",
      "departure_time": "10:43 PM",
      "arrival_time": "12:30 AM",
      "duration": "2 hr 47 min",
      "stops": 0,
      "price": 84,
      "is_best": true
    }
  ]
}

Links

Comments

Markdown supported