# Flight Search

> Search Google Flights for prices, times, and airlines. No API key required. Use when this capability is needed.

- Skill: `tomevault-io/flight-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/flight-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/flight-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/flight-search

---


# Flight Search

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

Built on [fast-flights](https://github.com/AWeirdDev/flights).

## Quick Start

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

# or install globally
uv tool install flight-search
flight-search JFK LHR --date 2025-06-15 --return 2025-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

```bash
# One-way flight
flight-search DEN LAX --date 2025-03-01

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

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

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

## Example Output

```
✈️  DEN → LAX
   One way · 2025-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:

```json
{
  "origin": "DEN",
  "destination": "LAX",
  "date": "2025-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

- [PyPI](https://pypi.org/project/flight-search/)
- [GitHub](https://github.com/Olafs-World/flight-search)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/demerzels-lab) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->