flights

フライト検索

Google Flights のデータを使用して、リアルタイムのフライトスケジュールと料金を検索します。

前提条件

• Python 3.9+
• uv（推奨）— curl -LsSf https://astral.sh/uv/install.sh | sh でインストールします

flights-search CLI は、このスキルディレクトリの scripts/flights-search に同梱されています。

fast-flights ライブラリは、初回実行時に uvx 経由で自動的にインストールされます（以降はキャッシュされます）。または、手動でインストールできます：pip install fast-flights

CLI の使用方法

uvx --with fast-flights python3 scripts/flights-search <origin> <destination> <date> [options]

出発地と目的地には、IATA コード（JFK、LAX）または都市名（NYC、London、Tokyo）を指定できます。都市名を指定すると、その都市圏内のすべての空港が自動的に検索されます。

例

# Search all NYC airports to LAX
flights-search NYC LAX 2026-03-15

# Nonstop flights from NYC to Berlin
flights-search NYC Berlin 2026-03-15 --nonstop

# Evening departures only
flights-search JFK LHR 2026-03-15 --after 17 --before 22

# Business class
flights-search NYC London 2026-03-15 --class business

# Multiple passengers with booking link
flights-search SF Tokyo 2026-04-01 --passengers 2 --link

オプション

オプション	説明
--nonstop	直行便のみ
--all-stops	経由回数にかかわらず、すべてのフライトを表示
--after HH	指定した時刻以降に出発（24 時間形式）
--before HH	指定した時刻より前に出発（24 時間形式）
--class	座席クラス：economy、premium、business、first
--passengers N	旅行者の人数（デフォルト：1）
--link	Google Flights の URL を出力

対応している都市名

都市名を指定すると、CLI はその都市圏内のすべての空港を検索します。

都市	空港
NYC / New York	JFK, EWR, LGA
LA / Los Angeles	LAX, BUR, LGB, ONT, SNA
SF / San Francisco	SFO, OAK, SJC
Chicago	ORD, MDW
DC / Washington	DCA, IAD, BWI
London	LHR, LGW, STN, LTN, LCY
Paris	CDG, ORY
Tokyo	NRT, HND
Toronto	YYZ, YTZ

60 以上の都市圏に対応しています。一覧にない空港には、IATA コードを直接指定してください。

デフォルトの動作

デフォルトでは、CLI は利用可能な最少の経由回数のフライトのみを表示します。

• 直行便がある場合 → 直行便のみ表示
• 直行便がない場合 → 乗り継ぎ 1 回のフライトのみ表示
• すべて表示するには --all-stops を使用します

出力

Searching from NYC: JFK, EWR, LGA

Route        Depart                       Arrive                       Airline          Price       Duration
------------------------------------------------------------------------------------------------------------
EWR→LAX      6:00 AM on Sat, Mar 7        9:07 AM on Sat, Mar 7        United           $289        6 hr 7 min
EWR→LAX      12:00 PM on Sat, Mar 7       3:14 PM on Sat, Mar 7        United           $289        6 hr 14 min
JFK→LAX      8:00 AM on Sat, Mar 7        11:30 AM on Sat, Mar 7       Delta            $304        5 hr 30 min

3 flight(s) found.

注意事項

• 日付形式：YYYY-MM-DD
• 空港コード：標準的な IATA コード（JFK、LAX、LHR など）
• 料金は USD 建てです
• 時刻は空港の現地時間で表示されます
• API キーは不要です — リバースエンジニアリングされた protobuf API 経由で Google Flights のデータを使用します
• 上流の解析上の制限により、一部の路線では料金のみが返され（出発時刻と到着時刻が欠落し）ます

データソース

Python パッケージの fast-flights を使用して、Google Flights のデータを取得します。