flyclaw

FlyClaw ✈️ - 航班情報集約検索ツール／フライト情報集約ツール

概要／概要

4つのデータソースを集約してフライトを検索 — ログイン不要、アカウント不要、API Key 不要の軽量な Python 実装です。 4つのデータソースを集約してフライトを検索します。ログイン、アカウント、API Key は不要です。ブラウザー自動操作を使わない軽量な Python 実装です。

オープンソースライブラリと無料の公開 API を利用するマルチソース集約アーキテクチャにより、フライトの運航状況、価格、時刻表、リアルタイムの位置などを取得します。中国語・英語の都市名と IATA コードを入力できます。

オープンソースライブラリと無料の公開 API を利用したマルチソース集約により、フライトの運航状況、価格、時刻表、リアルタイムの位置を取得します。中国語・英語の都市名と IATA コードに対応しています。

GitHub：https://github.com/AI4MSE/FlyClaw

API Key 不要／API Key 不要

すべての主要機能を、アカウント登録や API Key の提供なしで利用できます。すべてのデータはユーザーのローカル環境で管理され、プログラムが個人情報を収集・保存することはありません。また、ブラウザーのシミュレーションなどによる複雑さ、信頼性の低さ、効率の悪さも回避します。

アカウント登録や API Key は不要です。すべてのデータはローカルに保存され、個人情報を収集・保存することはありません。ブラウザー自動操作によるオーバーヘッドもありません。

起動方法／起動方法

ユーザーが「フライト CA981 を調べて」「上海からニューヨークまでいくら？」「明日の PVG 発 JFK 行きのフライト」「上海からシンガポールへの往復航空券」「北京からロンドンへのビジネスクラス」「乗り継ぎを含むすべてのフライト」「直行便」などと入力すると、自動的に実行されます。デフォルトでは、直行便とエコノミークラスを検索します。

ユーザーが「フライト CA981 を検索」「上海からニューヨークへのフライト」「PVG 発 SIN 行きの往復」「北京からロンドンへのビジネスクラス」「直行便」「乗り継ぎを含むすべてのフライト」などと入力すると起動します。デフォルトでは、直行便とエコノミークラスを検索します。

スマート変換ルール／スマート変換ルール：

• ユーザーが「すべてのフライト」「乗り継ぎを含む」「直行便以外も含む」と入力 → --stops any
• ユーザーが「直行便」「乗り継ぎなし」と入力 → --stops 0（デフォルト）
• ユーザーが「乗り継ぎは1回まで」と入力 → --stops 1
• ユーザーが「乗り継ぎは2回まで」と入力 → --stops 2

データソース／データソース

• Google Flights：国内線・国際線の価格、時刻表
• Skiplagged：国内線・国際線の価格、時刻表
• FlightRadar24：フライトの運航状況、リアルタイムの状態、遅延、機種
• Airplanes.live / ADSB.lol：ADS-B によるリアルタイムの位置情報

複数のソースに並行して問い合わせ、情報をスマートに統合します。プラグイン方式のアーキテクチャで、無制限に拡張可能です。各データソースは独立したモジュールです。公共の利益と幅広いユーザーのニーズに応える利便性を提供している、上記の公開データソースに感謝します。

機能／機能

1. フライト番号で検索：指定したフライトの運航情報（状態、時刻、遅延、機種など）を検索します
2. 路線で検索：2地点間のフライト一覧（価格、経由地、所要時間などを含む）を検索します
3. 都市単位で検索：都市名を入力すると、その都市にあるすべての空港を自動検索します（例：「上海」→ PVG + SHA）
4. 詳細検索：往復検索、複数の旅客数設定、座席クラスの選択、並べ替え、直行便の絞り込み
5. 中国語・英語入力：中国語の都市名、英語名、IATA コードに対応し、7,912 の空港を網羅

重要：出力形式と複数日検索／出力形式と複数日検索

デフォルトの出力は JSON（stdout）です。json.loads() でそのまま解析できます。例：

[{"flight_number": "CA981", "price": 472.0, "origin_iata": "PVG", "destination_iata": "GVA", ...}]

結果がない場合は [] を返します。エラーとログは stderr にのみ出力されるため、JSON の解析に影響しません。価格の単位はデフォルトで**米ドル（USD）**です。-o table を使うと、人間が読みやすい表形式に切り替えられます。

複数日検索：search コマンドで検索できるのは1回につき1日分です。1週間の最安値などを調べる場合は、日付ごとに分けて並行して実行し、それぞれの JSON 結果を取得してから、自分で統合して比較してください。

使用方法／使用方法

フライト番号で検索

python flyclaw.py query --flight CA981

路線で検索

python flyclaw.py search --from 上海 --to 纽约 --date 2026-04-01

往復検索

python flyclaw.py search --from PVG --to LAX --date 2026-04-15 --return 2026-04-25

ビジネスクラス + 2 人

python flyclaw.py search --from PVG --to JFK --date 2026-04-15 --cabin business -a 2

直行便 + 価格順に並べ替え

python flyclaw.py search --from PVG --to SIN --date 2026-04-15 --stops 0 --sort cheapest

経由便を含める

python flyclaw.py search --from PVG --to JFK --date 2026-04-15 --stops any

日付で検索結果を絞り込む

python flyclaw.py query --flight CA981 --date 2026-04-01
python flyclaw.py query --flight CA981 --date today

スマートな価格検索を無効にする

スマートな価格検索はデフォルトで有効です。フライト番号で検索する際に、価格情報を自動で補足します。無効にすると検索時間を短縮できます。

python flyclaw.py query --flight CA981 --no-relay

検索パラメーター

パラメーター	短縮フラグ	デフォルト値	説明
--from	—	（必須）	出発地
--to	—	（必須）	目的地
--date / -d	—	—	出発日 YYYY-MM-DD
--return / -r	—	—	復路の日付（往復検索を有効化）
--adults / -a	—	1	大人の旅客数
--children	—	0	子どもの旅客数
--infants	—	0	乳幼児の旅客数
--cabin / -C	—	economy	economy/premium/business/first
--limit / -l	—	制限なし	最大結果数（指定しない場合はすべて返します）
--sort / -s	—	—	cheapest/fastest/departure/arrival
--stops	—	0	経由：0=直行便/1/2/any=指定なし

共通パラメーター

• -o table：表形式で出力します（デフォルトは JSON）
• -v：詳細モードにして、データソースと座席クラスを表示します

入力例／入力例

ユーザーの入力	解析結果	説明
「上海」	PVG + SHA	都市単位：上海のすべての空港を検索します
「PVG」	PVG	浦東空港を正確に指定します
「浦東」	PVG	エイリアスを正確に照合します
「ニューヨーク」	JFK + EWR + LGA	都市単位：ニューヨークのすべての空港を検索します
「北京」	PEK + PKX + NAY	都市単位：北京のすべての空港を検索します
「Shanghai」	PVG + SHA	英語の都市名にも対応しています

インストール／インストール

pip install requests pyyaml curl_cffi flights
# 注意：不要安装 mcp、fast-flights、playwright 等调试模块，会增加安装时间且普通使用不需要

ファイルの場所：メインプログラムは flyclaw.py、設定ファイルは config.yaml、空港キャッシュは cache/airports.json です。

依存関係：Python 3.11+、requests（Apache-2.0）、pyyaml（MIT）、curl_cffi（MIT）、flights（MIT）。

セキュリティ／セキュリティ

• API Key 不要：プログラムの実行に、ユーザーによる API Key の提供やアカウント登録は必要ありません
• プログラムがユーザーの個人情報を収集・保存することはありません
• ネットワークリクエストは、公開されているフライト情報の検索にのみ使用されます

免責事項／免責事項

• 本ツールはマルチソース集約アーキテクチャを採用し、オープンソースライブラリと無料の公開 API を通じてデータを取得します
• 学習・研究目的に限って使用し、現地の法律や規制を遵守してください
• Google Flights は一部の地域で利用できない場合があります
• 価格データは複数のデータソースから取得しているため、ソースによって価格が異なる場合があります（税金の有無、座席クラスの違いなど）。あくまで参考情報としてご利用ください

---

作者／作者

公益を目的としたスキルで、無料のオープンソースです。／コミュニティ主導のオープンソースで、誰でも無料で利用できます。

• Email: [email protected]
• 小红书／小紅書: @深度连接
• GitHub: AI4MSE

ライセンス／ライセンス：Apache-2.0