flight-search

Original source / Raw SKILL.md

---
name: flight-search
description: Search Google Flights for prices, times, and airlines. No API key required.
homepage: https://github.com/Olafs-World/flight-search
metadata:
  {
    "openclaw":
      {
        "emoji": "✈️",
        "requires": { "bins": ["uvx"] },
        "install":
          [
            {
              "id": "uv",
              "kind": "pip",
              "package": "uv",
              "bins": ["uvx"],
              "label": "Install uv (for uvx)",
            },
          ],
      },
  }
---

# 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 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

```bash
# 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:

```json
{
  "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

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


---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### README.md

```markdown
![flight-search banner](https://raw.githubusercontent.com/Olafs-World/flight-search/main/banner.png)

# ✈️ flight-search

[![PyPI](https://img.shields.io/pypi/v/flight-search)](https://pypi.org/project/flight-search/)
[![Python](https://img.shields.io/pypi/pyversions/flight-search)](https://pypi.org/project/flight-search/)
[![License](https://img.shields.io/pypi/l/flight-search)](https://github.com/Olafs-World/flight-search/blob/main/LICENSE)

CLI tool to search Google Flights. Get prices, times, and airlines from the command line.

```bash
$ flight-search DEN LAX --date 2026-03-01

✈️  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
```

Built on top of [fast-flights](https://github.com/AWeirdDev/flights) - no API key required.

## Installation

```bash
# one-liner
curl -fsSL https://raw.githubusercontent.com/Olafs-World/flight-search/main/install.sh | bash

# using uv (recommended)
uv tool install flight-search

# or pip
pip install flight-search

# or run directly without installing
uvx flight-search DEN LAX --date 2026-03-01
```

## Updating

```bash
# check current version
flight-search --version

# update with uv
uv tool upgrade flight-search

# or with pip
pip install --upgrade flight-search

# or with pipx
pipx upgrade flight-search
```

## Usage

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

# Round trip
flight-search JFK LHR --date 2026-06-15 --return 2026-06-22

# Multiple passengers, business class
flight-search SFO NRT --date 2026-04-01 --class business --adults 2

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

## 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)
```

## JSON Output

```bash
flight-search DEN LAX --date 2026-03-01 --output json
```

```json
{
  "origin": "DEN",
  "destination": "LAX",
  "date": "2026-03-01",
  "return_date": null,
  "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
    }
  ]
}
```

## Troubleshooting

### "401 no token provided" error

This can happen when the underlying library's fallback request method fails. Workarounds:

1. **Try again** - Sometimes transient
2. **Use from a different network** - Some networks/regions have issues
3. **Install Playwright** for local browser mode:
   ```bash
   pip install playwright
   playwright install chromium
   ```

The library scrapes Google Flights directly. It doesn't require an API key, but Google's anti-bot measures can sometimes block requests.

## Python API

```python
from flight_search import search_flights

result = search_flights(
    origin="DEN",
    destination="LAX", 
    date="2026-03-01",
    adults=2,
    seat_class="economy",
)

for flight in result.flights:
    print(f"{flight.airline}: ${flight.price}")
```

## Links

- [GitHub](https://github.com/Olafs-World/flight-search)
- [PyPI](https://pypi.org/project/flight-search/)
- [ClawHub Skill](https://clawhub.com/skills/flight-search)
- [fast-flights](https://github.com/AWeirdDev/flights) (underlying library)

## Self-Update

```bash
# Auto-detects how you installed it (uv/pipx/pip) and upgrades
flight-search --upgrade
```

```

### _meta.json

```json
{
  "owner": "awlevin",
  "slug": "flight-search",
  "displayName": "Flight Search",
  "latest": {
    "version": "0.1.7",
    "publishedAt": 1770362463005,
    "commit": "https://github.com/openclaw/skills/commit/ed6d5626dca96c50f23f4257d5462d30fc04f5d2"
  },
  "history": [
    {
      "version": "1.0.0",
      "publishedAt": 1770357958746,
      "commit": "https://github.com/openclaw/skills/commit/2afe1494804a18df51bc50957e794c5e81912c30"
    }
  ]
}

```