lessons-learned

学んだ教訓

実際の検索から得た、苦労して身につけた知識です。同じ失敗を繰り返さないよう、事前に確認してください。

Seats.aero：すべてのソースを検索し、すべての結果を表示する

Seats.aero を検索する際、最初の検索でソースを絞り込んではいけません。 まず、すべてのプログラムを取得してください。

必須のワークフロー

どのルートでも、次の手順に従ってください。

1. ソースを指定せずに Seats.aero を検索します。 すべてのプログラムを取得し、最安値順に並べた全結果を表示します。
2. 結果にあるすべてのプログラムについて、利用可能な経路を最後までたどります。 a. 直接保有する残高はありますか？（接続済みの場合は AwardWallet を確認） b. ポイント移行の経路はありますか？（すべてのポイント通貨について data/transfer-partners.json を確認：Amex MR、Chase UR、Bilt、Capital One） c. アライアンス経由の経路はありますか？運航航空会社のアライアンス（data/alliances.json）を特定し、そのアライアンスに属するプログラム、または二者間提携（data/partner-awards.json）のあるプログラムをすべて探してから、それらのうちポイント移行で利用可能なものを確認します。 d. アライアンスをまたぐ経路はありますか？data/partner-awards.json の cross_alliance_highlights と二者間提携を確認します。
3. 利用可能な経路があるプログラムで、Seats.aero のキャッシュデータがない場合は、 プログラムのウェブサイト（airfrance.com、united.com など）を直接確認します。
4. 全体像を漏れなく提示します。 利用可能かどうかにかかわらず、すべての選択肢とポイント移行の経路を明記します。
5. その後で初めて、特典航空券と現金の価格を比較します。

よくある失敗

検索結果に航空会社が表示された後、わかりやすいプログラムを1つか2つ確認しただけで、特典航空券は「利用できない」または「価値が低い」と判断し、現金での購入を勧めてしまうことです。アライアンスや二者間提携を通じて考えられる経路をすべて必ずたどってください。運航航空会社がアライアンスに加盟している場合、そのアライアンスの特典航空券を予約できるすべてのプログラムが、利用可能な経路になり得ます。

「利用可能なキャッシュデータなし」で判断を終わらせない

これは、Seats.aero が最近データを取得していないという意味です。利用可能な経路があるプログラムにキャッシュされた結果がない場合、特典航空券は利用できないと判断する前に、航空会社のウェブサイトを直接検索してください。

データファイルより実際の情報を優先する

データファイルは参考資料であり、絶対的な情報ではありません。航空会社の提携関係は常に変化します。ユーザーが、データに記載のない予約経路が使えると言った場合は、反論する前に実際の予約サイトで確認してください。正しい情報源はウェブサイトです。ファイルはキャッシュにすぎません。データファイルと実際の情報が異なる場合は、データファイルを更新してください。

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

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

1. Duffel は運賃クラスごとの実際の GDS 価格を返します。 これらの価格で予約できます。確認例：Duffel はベーシックを $271、メインを $325 と表示しました。同じ便について SerpAPI は $541 と表示しました。この差は複数の旅程で一貫していました。
2. SerpAPI（Google Flights）は価格を高く表示します。 Google Flights は、最安値で予約できる運賃クラスではなく、「メインキャビン」やパッケージ運賃を表示することがよくあります。Google Hotels や旅行先の検索には便利ですが、現金で購入する航空券の価格情報として単独で信頼しないでください。
3. Kiwi は小規模市場では役に立たない結果を返します。 小規模空港への国内線では、結果を厳しく絞り込むか、Kiwi を使わないでください。

Southwest は例外です

1. Southwest はどの GDS にも登録されていません。 Duffel、Skiplagged、Kiwi、Seats.aero から SW の便が返されることはありません。情報源は Southwest のウェブサイト、またはユーザー提供のスクリーンショットのみです。
2. SerpAPI は SW の価格を返します が、SerpAPI の航空券価格全般と同じく、高めに表示されることがよくあります。参考程度に扱ってください。
3. SW Companion Pass の計算方法は、ほかのすべての場合と異なります。 CP があれば、航空券を1枚購入すると、同伴者は無料で搭乗できます。現金価格の比較には、Choice 運賃の1人分（Basic 運賃2人分ではありません）を使います。ポイントで比較する場合は、2人分を合計ポイント数でまかないます。この違いによって、cpp の計算結果は大きく変わります。
4. SW の航空券を現金で購入する場合、同伴者を無料にするには Choice 運賃以上が必要です。 Wanna Get Away（Basic）は対象外です。重要な点です。
5. SW のポイント価格は southwest.com で確認する必要があります。 第三者の情報源では確認できません。

コンパニオンパスのCPP計算

コンパニオンパスを利用する場合の正しい計算式：

Total cash value = choice_fare_cash × 2 passengers
CPP = total_cash_value / total_points × 100

1人分の航空券に必要なポイントで、2人分の旅行ができます。常に「ポイントで2人分の旅行を$X分購入できた」と表現してください。

小規模市場の空港

小規模空港では特典航空券の空席が限られています。Seats.aeroのキャッシュデータは少ない場合があります。小規模市場を検索する場合：

1. 現金価格はDuffelで検索する（GDSに在庫があるため、問題なく機能します）
2. Seats.aeroのキャッシュ検索は使わない（データが少なすぎます）
3. 必要に応じて、航空会社のウェブサイトで個別のプログラムの特典航空券の料金を確認する
4. 小規模な国内市場では、SW Companion Passが有利になることがよくあります。ポイントの必要数が少なく、CPで価値が2倍になるためです

乗り継ぎ時間と時間帯の希望

最初の検索時に、ユーザーの希望を尋ねてください。主な質問：

• 乗り継ぎ時間の最短と最長
• 出発可能な最も早い時間
• 深夜便を許容できるか
• ラウンジの利用（乗り継ぎ時間の感じ方が変わります）

回答を保存し、セッション中の以降の検索すべてに適用してください。

Duffelの制限事項

• Southwestには対応していません。 SWはどのGDSにも含まれていません。以上です。
• 特典航空券の料金は表示されません。 Duffelに表示されるのは現金運賃のみです。特典航空券の空席状況にはSeats.aeroを使用してください。
• オファーの有効期限は15～30分です。 Duffelの検索結果をセッションをまたいでキャッシュしないでください。
• 60秒あたり60件のリクエスト制限があります。 並列検索は問題ありませんが、やりすぎないでください。
• 同じフライトに対して複数の運賃クラスが返されます。 これは仕様です。同じ経路でも、ベーシックエコノミーとメインキャビンが異なる価格で表示されます。ユーザーが運賃の希望を指定していない場合は、CPPの比較に予約可能な最安クラスを使用してください。

関連するリファレンススキル（該当する場合に読み込みます）

すべての検索で必要なわけではありませんが、会話の文脈に応じて読み込んでください。

• transfer-bonuses — クレジットカードのポイントをロイヤルティプログラムへ移行することをおすすめする前に読み込みます。現在有効なボーナスの週次データを掲載しています（例：Amex MR → Hilton 20％、Chase UR → Aeroplan 20％に、カード会員向けの併用可能なボーナスが加算）。30％のボーナスがあると、移行パートナーの最適化でどのポイントが最も割安かが変わります。
• stopovers — 乗り継ぎ時間が24時間近い場合や、「途中でXに立ち寄りたい」とユーザーが希望している場合に読み込みます。一次資料を引用した17のプログラムを記載しています：Aeroplan（ストップオーバー1回、追加料金5K）、TAP（提携航空会社の特典航空券で1回）、Turkish（イスタンブールで無料のストップオーバー）、Etihad（アブダビ）、Icelandair（レイキャビクで最大7日間無料、伝説的な特典）、Alaska（無料、電話のみ）、Flying Blue（無料、回数無制限の可能性あり）、JALマルチキャリア（最大3回）、Singapore Saver／Advantageの各ティア、AF/KLM、Cathay（2+2）。ストップオーバーを認めていないプログラム（BA Avios、AA AAdvantage、Delta SkyMiles、JetBlue、Virgin Atlantic、Iberia Avios）も記載しています。これは重要な否定的調査結果です。
• award-holds — 「先にポイントを移行する」という提案をする前に読み込みます。現在のデータに基づく保留対応状況：AAではオンラインでセルフサービスによる24時間の保留が可能です（オンライン保留に対応している唯一のプログラムです。以前の5日間の保留は2024年後半に終了しました）。Virgin Atlantic Flying Clubでは電話で1～2日間、無料で保留できます。Flying Blueでは電話で最大3日間保留できますが、発券時に電話予約手数料25ドルがかかります。Lufthansa M&Mでは最大5日間、Cathayでは約2日間保留できます。Singaporeでは担当者の裁量によります。保留に対応していない主な欧米のプログラムは、United、Alaska、Delta、BA、Aeroplanです。この概要だけに頼らず、必ずデータファイルを確認してください。
• round-the-world — 旅行に3回以上の立ち寄り、または複数の地域が含まれる場合に読み込みます。現行の13商品と終了した4商品を記載しています。RTWの選択肢は縮小しつつあり（過去18か月で4商品が終了）、Star Alliance、oneworld、Lufthansa M&M、Qantasは引き続き有力です。26,000マイルの特別なビジネスRTWは非常にお得です。Iberia Plusのヨーロッパ域内のお得な特典や、Aeroplanの距離制地域特典も含みます。
• status-match — ユーザーが上級会員資格への近道、ステータスマッチ、ステータスチャレンジ、ロイヤルティプログラムの乗り換えについて尋ねた場合や、たまにしかない機会（Hyatt Globalist Challenge、Marriott Platinum Challengeなど）に言及した場合に読み込みます。生涯に1回／数年に1回という重要な注意事項：Alaska Atmosは生涯で1回、AAは2年に1回、Delta／Unitedは3年に1回、Hyatt Globalist Challengeは生涯で1回です。このスキルでは、無料の直接マッチ、有料のコンシェルジュサービス（statusmatch.comは実在しますが、料金がかかります）、カード付帯の更新可能なステータス（Amex PlatinumならHilton GoldとMarriott Goldが自動付与）を区別しています。