flight-search-strategy

フライト検索戦略

フライトを検索するたびに、すべての情報源を検索する

これは、どれか1つを選ぶリストではありません。情報源ごとに検索結果、価格、航空会社が異なります。情報源を1つでも見落とすと、選択肢を逃します。優先順位は、情報源間で価格が一致しない場合にどの価格を信頼するかを示すものであり、どの情報源を省略するかを示すものではありません。

優先順位	情報源	強み	見落としやすい点
1	Duffel（スキル）	現金価格が最も正確です。運賃クラスごとの実際のGDSデータを使用します。予約可能です。	Southwestには対応していません。特典航空券の価格には対応していません。オファーの有効期限は15～30分です。
2	Ignav（スキル）	高速なREST APIです。価格裁定のための市場選択が可能です。無料です。	Southwestには対応していません。特典航空券の価格には対応していません。
3	Google Flights（スキル、agent-browser）	現金価格ではSouthwestを含むすべての航空会社を網羅しています。無料です。エコノミーとビジネスを比較できます。	価格がGDSより高くなる場合があります。ポイント価格には対応していません。
4	Skiplagged（MCP）	隠れ都市運賃に対応しています。設定不要です。	Southwestには対応していません。小規模市場ではノイズが多くなる場合があります。
5	Kiwi.com（MCP）	仮想インターライニング（複数の航空会社を組み合わせた柔軟な経路）に対応しています。設定不要です。	小規模市場では使いものにならない結果が返る場合があります。Southwestには対応していません。
6	Seats.aero（スキル）	25以上のプログラムの特典航空券の空席状況を検索できます。ポイント検索の決定版です。	キャッシュデータであり、リアルタイムではありません。現金価格には対応していません。Southwestには対応していません。
7	SerpAPI（スキル、オプション）	Google Hotels検索に対応しています。目的地の探索（Google Travel Explore）に使えます。	フライト検索には使用しないでください（価格が高く表示されます）。ホテル検索と「どこに行けばよいか」の検索専用です。
8	Southwest（スキル、Patchright）	運賃クラス、ポイント価格、Companion Passに対応しています。4つすべての運賃クラスで現金とポイントの両方を検索できます。	事前構築済みのDockerイメージ：ghcr.io/borski/sw-fares。またはローカルのPatchright（ヘッドありモード）。検索1回あたり約20秒です。

標準的なフライト検索ワークフロー

以下をすべて並列で実行します： Duffel + Ignav + Google Flights + Skiplagged + Kiwi。

SkiplaggedとKiwiはキー不要のMCPサーバーです。適切に起動したセッションでは常に利用できます。MCPを利用できないと判断する前にツール呼び出しを試し、これらの情報源の代わりに場当たり的なブラウザーのスクレイピングを使用しないでください（fallback-and-resilienceを参照）。

特典航空券との比較には、常にSeats.aeroを追加してください。SWがその路線を運航している場合は、必ずSouthwestのスキルも実行してください。

情報源を省略しないでください。1つの情報源ですべてを網羅できると決めつけないでください。どの情報源で見つかったかにかかわらず、最適な選択肢を強調して、統合した検索結果を提示してください。

**統一された比較を行うには、**上記すべてを並列で実行し、乗り継ぎパートナーの最適化を適用するcompare-flightsスキルを使用してください。

往復と片道の組み合わせ

復路の日付がある場合は、頼まれる前に、次の両方の構成で積極的に価格を調べてください。

1. すべての情報源（Duffel、Ignav、Kiwi、Skiplagged、Google Flights）での往復運賃。
2. 2つの片道運賃を個別に検索します。これにより、往復検索では見つからない、異なる航空会社の組み合わせ（往路は航空会社A、復路は航空会社B）も確認できます。

すべてを同じ並列処理で実行します。検索を2回追加するだけで、2回目の検索処理は必要ありません。

どちらが有利かは路線によって異なるため、決めつけないでください。

• **国際線では、レガシーキャリアの往復運賃が有利になることがよくあります。**往復運賃は片道運賃2つの組み合わせより割引されている場合があります。
• **国内線、ULCC、Southwestが運航する路線では、片道運賃の組み合わせが有利になることがよくあります。**Southwestは各区間を片道として価格設定しています。また、各区間を個別に変更またはキャンセルできるため、柔軟性も高まります。
• 往路と復路で異なる航空会社のセール運賃が適用される場合、航空会社を組み合わせた片道運賃が往復運賃と片道運賃の組み合わせの両方を上回ることがよくあります。

差額を示して、結論を明確に提示してください：「往復は842ドル、最安の片道運賃の組み合わせは918ドルです。往復のほうを予約すると76ドル節約できます」（またはその逆）。差額が約50ドル未満の場合は、往復を勧める前に、別々の航空券にすることで得られる柔軟性について伝えてください。

Southwest 専用

Southwest スキルを使用します。

docker run --rm ghcr.io/borski/sw-fares --origin SJC --dest DEN --depart 2026-05-15 --points

または：

python3 skills/southwest/scripts/search_fares.py --origin SJC --dest DEN --depart 2026-05-15 --points

4 種類すべての運賃クラス（Wanna Get Away、WGA+、Anytime、Business Select）について、現金およびポイントでの料金を返します。

google-flights スキルは、現金価格のみを確認するための高速な代替手段です（運賃クラスの内訳とポイント料金は表示されません）。

Southwest の予約済みフライトのモニタリング

docker run --rm -e SW_USERNAME -e SW_PASSWORD \
  ghcr.io/borski/sw-fares change --conf ABC123 --first Jane --last Doe --json

ログインして、往路と復路の両方を選択し、利用可能なすべてのフライトについて運賃差額を表示します。差額がマイナスの場合は、節約の機会があります。--list を使うと、今後の予約確認番号をすべて確認できます。読み取り専用です。予約内容は一切変更されません。

市場の選択戦略

国ごとの市場によって、同じ路線でも価格が異なります。タイ（&gl=TH）から検索すると、米国（&gl=US）から検索する場合と比べて、数百ドル節約できることがあります。

国際線では、必ず複数の市場を試してください。

1. まず出発国の市場（例：米国発のフライトでは &gl=US）
2. 次に目的地の国の市場（例：日本行きのフライトでは &gl=JP）
3. さらに試す前にユーザーに確認する（例：第 3 国、VPN を使った市場）

これは次の検索方法に適用されます。

• &gl=XX URL パラメーターを使う google-flights
• 検索ペイロードの market フィールドを使う ignav

Duffel と SerpAPI は市場の選択に対応していません。

情報源の正確性の優先順位

現金価格について情報源間で食い違いがある場合：

Duffel > 航空会社のウェブサイト > SerpAPI > Skiplagged/Kiwi

1. Duffel は運賃クラスごとの実際の GDS 価格を返します。 これらの価格で予約できます。テストでは、Duffel はベーシックを 271 ドル、メインを 325 ドルと表示しました。同じフライトを SerpAPI は 541 ドルと表示しました。この差は複数の旅程で一貫していました。
2. SerpAPI（Google Flights）は価格を高めに表示します。 多くの場合、最安の予約可能な運賃クラスではなく、「メインキャビン」や付帯サービス込みの運賃を表示します。Google Hotels や旅行先の検索には便利ですが、航空券の現金価格を調べる唯一の情報源として信頼しないでください。
3. Kiwi は小規模市場では使えない結果を返します。 小規模空港への国内線では、結果を厳しく絞り込むか、Kiwi を使わないでください。

よくある失敗パターン

• 1 つの情報源だけを使い、他の情報源にあるより良い選択肢を見逃す。
• SerpAPI の価格を予約可能な価格として信頼する（実際には高めに表示されることがよくあります）。
• 「GDS にないから」と Southwest を検索対象から外す。だからこそ SW スキルが必要です。
• ユーザーが「そのポイントを持っていないから」と Seats.aero を検索対象から外す。ポイント移行で利用できる場合があるため、partner-awards スキルを確認してください。
• 国際線で 1 つの市場だけを検索する（必ず少なくとも 2 つの市場を試してください）。