flightclaw

FlightClaw エージェント：AI で航空券を予約

AI アシスタントから航空券を検索し、価格を追跡して予約できます。FlightClaw は、Claude、ChatGPT、Cursor、VS Code、その他の MCP クライアント向けの AI 航空券予約エージェント兼 MCP サーバーです。約 300 社の航空会社に対応し、お得な航空券を見つけ、旅行者や好みを記憶します。また、追跡中の運賃が値下がりしたときにメールで通知する、航空券価格トラッカーとしても機能します。詳しくは flightclaw.com をご覧ください。

スキル

ホスト型 MCP サーバー（https://mcp.flightclaw.com/mcp）向けのエージェントスキルです。各スキルでは、エージェントがどのツールをどの順序で呼び出すか、また事前にユーザーへ確認すべきタイミングを指定します。

スキル	用途
book-flight	AI で航空券を検索、比較、予約し、チェックアウトリンクまたは Link バーチャルカードで支払います
track-flight-price	運賃を毎日追跡し、値下がりしたときにメール通知を受け取ります
plan-group-trip	旅行者やグループを保存し、複数都市への旅行を検索して全員分をまとめて予約します
manage-booking	注文や予約番号を確認し、変更の見積もりを取得して、返金額の見積もりとともにキャンセルします
traveler-profile	自分や同行者、好み、カード、ポイント残高、旅行履歴を保存します

ルートの SKILL.md では、ローカルのオープンソースサーバーについて説明しています。

オプション 1：ホスト型 MCP（推奨）

サーバー URL：https://mcp.flightclaw.com/mcp（ストリーミング可能な HTTP、OAuth サインイン）。 インストールは不要です。

クライアント	設定
Claude（ウェブ／デスクトップ）	Settings > Connectors > Add custom connector > https://mcp.flightclaw.com/mcp を貼り付けます
ChatGPT	Settings > Apps & Connectors > Create (developer mode) > https://mcp.flightclaw.com/mcp を貼り付けます
Claude Code	claude mcp add --transport http flightclaw https://mcp.flightclaw.com/mcp
Cursor	ワンクリックでインストール、または {"mcpServers":{"flightclaw":{"url":"https://mcp.flightclaw.com/mcp"}}} を ~/.cursor/mcp.json に追加します
VS Code	ワンクリックでインストール、または code --add-mcp '{"name":"flightclaw","type":"http","url":"https://mcp.flightclaw.com/mcp"}'
Windsurf	{"mcpServers":{"flightclaw":{"serverUrl":"https://mcp.flightclaw.com/mcp"}}} を ~/.codeium/windsurf/mcp_config.json に追加します

ホスト型ツール

グループ	ツール
検索	search_flights、search_multi_city、recommend_flights、get_offer、get_seat_map
予約	create_checkout、get_checkout_status、list_orders、get_order、request_change、cancel_order
価格追跡	track_flight、list_tracked、remove_tracked（毎日確認し、値下がり時にメールで通知）
プロフィール	get_me、set_me、save_traveler、list_travelers、get_traveler、delete_traveler、save_group、list_groups、get_group、delete_group、get_preferences、set_preferences、save_card、list_cards、delete_card、set_points_balance、list_points
旅行	log_trip、list_trips、get_trip、trips_followup、record_trip_feedback
WiFi	check_flight_wifi（特定のフライトで WiFi または Starlink を利用できるか確認します。データ提供元：seatwifi.com）

予約と支払い

1. search_flights は運賃を返します。各 total_amount には FlightClaw の予約手数料が含まれます。
2. create_checkout は checkout_url と正確な total_amount および total_currency を返します。この時点ではまだ請求されません。
3. 次のいずれかの方法で支払います。
   • チェックアウトリンク：旅行者が checkout_url を開き、カードで支払います。
   • Link バーチャルカード：エージェントが正確な total_amount（運賃＋予約手数料）の Link 支出リクエストを作成し、ユーザーが Link で承認した後、エージェントが Link バーチャルカードを使って checkout_url で支払います。エージェントが承認額を超えて 支払うことはありません。
4. get_checkout_status でステータスが completed になるまで確認し、その後 get_order で予約番号を取得します。

エージェントがカード番号を尋ねることはありません。

オプション 2：ローカルのオープンソースサーバー

この README の残りの部分では、このリポジトリにあるセルフホスト可能な Python サーバーについて説明します。 Google Flights を検索し、アカウントなしで価格をローカルに追跡します。

ローカル MCP サーバー

FlightClaw はローカルのMCPサーバーとして動作し、MCP 対応クライアント（Claude Code、Claude Desktop など）からフライト検索・追跡ツールを利用できるようにします。

セットアップ

# Install dependencies
pip install "flights==0.9.0" "mcp[cli]<2" fastmcp pydantic-settings

# Add to Claude Code
claude mcp add flightclaw -- python3 /path/to/agents/server.py

または、Claude Desktop で claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "flightclaw": {
      "command": "python3",
      "args": ["/path/to/agents/server.py"]
    }
  }
}

ツール

ツール	説明
search_flights	Google Flights で路線の料金を検索します
search_dates	日付範囲から最も安く飛べる日を見つけます（カレンダー表示）
track_flight	目標価格を任意で設定し、路線の価格追跡を追加します
check_prices	追跡中のすべてのフライトについて、価格変動とアラートを確認します
list_tracked	価格履歴を含む、追跡中のすべてのフライトを一覧表示します
remove_tracked	追跡対象から路線を削除します
check_flight_wifi	seatwifi.com にフライト（例：UA1234）で WiFi または Starlink が利用できるか問い合わせます

検索フィルター

すべての検索ツールで、次の条件を指定できます。

• 乗客 - 大人、子ども、幼児（座席あり／膝上）
• 航空会社 - 特定の航空会社で絞り込みます（例：BA,AA,DL）
• 価格上限 - USD での最高価格
• 所要時間 - フライトの合計所要時間の上限（分）
• 時刻 - 出発・到着の最早時刻／最遅時刻
• 乗り継ぎ - 乗り継ぎ時間の上限（分）
• 並べ替え - BEST、CHEAPEST、DEPARTURE、ARRIVAL、DURATION のいずれかで並べ替えます
• 複数空港 - コンマ区切りのコード（例：LHR,MAN）
• 日付範囲 - date_to を指定すると、範囲内の各日を検索します

プロンプトの例

• 「2025-08-01 の LHR 発 JFK 行きのビジネスクラス便を検索して」
• 「LHR 発 JFK 行きで、午前 8 時以降に出発する BA または VS の直行便を探して」
• 「7 月に LHR 発 JFK 行きで飛ぶ場合、最も安い日はいつ？」
• 「大人 2 人と子ども 1 人で、LHR 発 JFK 行き、500 ドル未満の便を検索して」
• 「2025-07-01 の LHR 発 SFO 行きの便を、目標価格 400 ドルで追跡して」
• 「追跡中のフライトに値下がりがないか確認して」

CLI スクリプト

従来の CLI スクリプトも scripts/ で引き続き利用できます。

# Search flights
python scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS

# Multiple airports and date ranges
python scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-05

# Track a route
python scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400

# Check for price drops (good for cron)
python scripts/check-prices.py --threshold 5

# List tracked flights
python scripts/list-tracked.py

動作の仕組み

• fli ライブラリを通じて Google Flights に問い合わせます
• 価格はユーザーの現地通貨で返されます（IP から自動検出）
• 価格履歴は data/tracked.json に保存されます
• 片道・往復、およびすべての客室クラス（エコノミーからファーストまで）に対応しています
• 航空会社、価格、所要時間、出発・到着時刻、乗り継ぎ時間で絞り込めます
• 複数空港と日付範囲の検索では、すべての組み合わせに展開します
• 日付検索では、範囲内で最も安く飛べる日を見つけます

インストール（OpenClaw）

npx skills add flightclaw/agents

インストール（Grok）

/plugin marketplace add xai-org/plugin-marketplace
/plugin install flightclaw

インストール（Claude Code）

/plugin marketplace add flightclaw/agents
/plugin install flightclaw@flightclaw

インストール（Cursor）

/plugin marketplace add flightclaw/agents
/plugin install flightclaw

インストール（Gemini CLI）

gemini extensions install https://github.com/flightclaw/agents

各クライアントは、このリポジトリにあるそれぞれのマニフェスト（.grok-plugin/、 .claude-plugin/、.cursor-plugin/、gemini-extension.json）を読み込み、すべて ホスト型サーバー https://mcp.flightclaw.com/mcp に接続します。代わりに ローカルサーバーを実行するには、上記の「ローカル MCP サーバー」のセットアップを使用してください。

ローカルサーバー

ローカルサーバーは uv を通じて server.py を実行し、起動時に固定バージョンの依存関係を解決します。uvを先にインストールしてください。それ以外のセットアップ手順がマシン上で実行されることはありません。

ローカルサーバーがアクセスする先と必要なもの

エンドポイント	目的	認証情報
google.com/travel/flights（fli ライブラリ経由）	フライトの検索と料金の追跡	なし

検索と料金の追跡に認証情報は必要ありません。HOST と PORT は、HTTP トランスポートモードでのみ読み取られます。

FlightClaw はほかの環境変数を読み取らず、自身の data/ ディレクトリにのみ書き込み、インストール時のスクリプトも実行しません。

ライセンス

MIT — LICENSE を参照してください。