flight-search

name	flight-search
description	Search for flight options with price and duration optimization. Find top 5 cheapest flights and top 5 fastest flights between airports. Use when user needs flight recommendations, price comparisons, travel time comparisons, or flight booking research. Supports multiple search strategies (cheapest first, fastest first).

Flight Search Agent

Find and compare flight options across multiple dimensions.

Capabilities

• Cheap search: Find lowest price flights (top 5)
• Fast search: Find shortest duration flights (top 5)
• Multi-airport support: IATA codes (SIN, BKK, NRT, etc.)
• Flexible dates: Search specific departure dates
• Cabin classes: Economy, Premium, Business, First

Quick Usage

Run the search script:

python3 scripts/search_flights.py \
  --origin SIN \
  --destination BKK \
  --date 2025-04-15 \
  --passengers 1 \
  --cabin economy

Parameters

Flag	Description	Example
--origin, -o	Origin IATA code	SIN, KUL, CGK
--destination, -d	Destination IATA code	BKK, NRT, HKG
--date	Departure date	2025-04-15
--passengers, -p	Number of travelers	1, 2
--cabin, -c	Cabin class	economy, business
--json	Output as JSON	(flag)

Implementation Notes

The current scaffold uses placeholder data. For production use, integrate with:

• Google Flights (unofficial scraping)
• Skyscanner API
• Amadeus API
• Kayak scraping

See references/ for API documentation and scraping guides.

Common Workflows

Find cheapest flights

python3 scripts/search_flights.py -o SIN -d BKK --date 2025-05-01

Compare options

python3 scripts/search_flights.py -o SIN -d NRT --date 2025-06-10 --json

Business class search

python3 scripts/search_flights.py -o SIN -d LHR --date 2025-07-20 --cabin business