Communitygithub.com

旅行料金プランナー(Travel Price Planner)

航空券、宿泊、鉄道、複合旅行の料金とリスクを比較して最適な旅程を提案するCodexスキルです。

旅行料金プランナー(Travel Price Planner) とは?

このスキルは、AIエージェント(特にCodex)向けに設計された旅行料金比較ツールです。航空券、ホテル、鉄道、またはこれらを組み合わせた複合旅行において、表示価格だけでなく、総支払額、追加料金、スケジュール適合性、予約主体、アフターサービス、払い戻し・変更・キャンセル条件、乗り継ぎリスクなどを総合的に評価し、最も合理的な予約経路を推奨します。 主な機能として、ユーザーの制約条件(日程、予算、人数、所要時間など)を収集し、複数の検索ソース(Google Flights、Booking.com、各国鉄道公式サイトなど)から価格を取得・比較します。また、リスク評価ルールに基づいてOTA予約や別送手荷物、乗り継ぎリスクなどをスコアリングし、決定論的な比較テーブルを生成するための正規化スクリプトも提供します。 重要なのは、実際の購入やログイン、個人情報の入力は一切行わず、予約確定前にはユーザーの明示的な確認を求める点です。このスキルは、信頼性の高い旅行計画立案とリスク管理を支援します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add AichenFilm/travel-price-planner-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

旅行料金プランナー

基本ルール

最も安い単純表示価格ではなく、最も合理的な低価格オプションを見つけること。予約経路を推奨する前に、最終的な支払額、必要な追加サービス、スケジュール適合性、予約主体、アフターサービス、払い戻し・変更・キャンセル条件、乗り継ぎリスクまたは滞在リスクを比較すること。

予約、支払い、ログイン、個人情報の入力、資格情報の保存、キャプチャ回避、ステルスまたは検出回避スクレイピングを行わないこと。購入またはアカウント操作の前に停止し、ユーザーの明示的な確認を求めること。

ワークフロー

  1. 不足している影響の大きい制約のみを収集する:日付の柔軟性、出発地/到着地の柔軟性、旅行者数、荷物、必着時間、予算上限、払い戻しの必要性、支払い通貨、ビザ/乗り継ぎ制限、宿泊エリア、キャンセル条件、鉄道時間の好み。
  2. ユーザーが自身の好みを明示していない場合、または再利用可能なテンプレートが必要な場合、references/default-preferences.md を読む。
  3. references/source-matrix.md を読み、旅行タイプと地域に応じて検索ソースを選択する。
  4. 通常のWebまたはブラウザアクセスを通じて最新価格を確認する。最終確認が重要な場合は公式ソースを優先する。ソースURL、タイムスタンプとタイムゾーン、通貨、最終表示合計額、予約/発券事業者、手荷物または朝食、キャンセル/払い戻し/変更条件、および表示されている手数料を記録する。
  5. オプションにOTA予約、自己乗り継ぎ、別送券、不明瞭な手荷物、返金不可の宿泊、鉄道代理店、乗り継ぎ国、異常な割引、ログイン限定価格、または不安定なイベント期間が含まれる場合は、常に references/risk-rules.md を読む。
  6. references/scoring-model.md を読み、総コストと予約リスクによってオプションをランク付けする。
  7. 多数の見積もり行がある場合、CSVを組み立て、scripts/normalize_travel_quotes.py を実行して決定論的な比較テーブルを生成する。このスクリプトは手動で収集した見積もりのみを正規化し、最新価格を取得しない。
  8. 推奨事項を提示する:最良の総合オプション、最も安い許容可能オプション、避けるべきオプション、正確な予約経路、および最終チェックアウトページで確認すべき事項。

ソース戦略

  • 航空券:日付とルートの発見にはGoogle Flightsなどのメタ検索ソースから始め、最も有力な旅程を航空会社公式サイトで確認する。OTAや二次メタ検索ソースは、有意な価格差が存在するかどうかを確認するためにのみ使用する。
  • 宿泊:エリアと価格帯の発見には地図またはホテルメタ検索ソースから始め、主要OTAと物件公式サイトを比較する。最終的な税、手数料、部屋タイプ、キャンセル条件、デポジット、朝食、および場所調整後の交通費を比較する。
  • 鉄道:運賃クラスとルールについては公式鉄道事業者を優先する。比較、利便性、またはマルチモーダル発見のためにTrainline、Omio、Trip.com、または類似の代理店を使用する。
  • Skyscanner、Amadeus、Duffel、Hotelbeds、Expedia RapidなどのAPIは、正規のアカウントとユーザー提供の環境変数が必要である。設定されていない場合、APIアクセスをでっち上げたり、ライブAPIのカバレッジを暗示したりしないこと。

出力基準

以下の階層を区別すること:

  • recommended:最良の総コスト/リスクバランス。
  • cheapest acceptable:実際に予約可能な最も安いオプション。
  • optional:許容可能だが、総合的に最強でも最も安い許容可能オプションでもない。
  • cheaper but risky:価格は低いが、アフターサービス、払い戻し、手荷物、乗り継ぎ、ビザ、または隠れた手数料のリスクがある。
  • avoid:ユーザーが明示的にリスクを受け入れない限り推奨しない。

各推奨オプションについて、具体的な予約経路を含めること。例:Google Flights -> airline official site、Booking.com refundable rate、Trenitalia official site、12306 official site。

正確性が重要な場合、原文の運賃ルール、キャンセル文、手荷物ルール、プラットフォーム名を保持し、その後ユーザーの言語で平易に説明すること。

スクリプトの使用

見積もり行を収集した後、正規化ツールを使用する:

python3 /path/to/travel-price-planner/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0.92 --fx CNY=0.127 --direct-margin 50 --format markdown

スクリプトのパスはこのスキルディレクトリからの相対パスで解決すること。カレントワーキングディレクトリがスキルディレクトリであると想定しないこと。

最低限必要なCSV列:

label,category,source,currency,total_price,mandatory_fees,baggage_fee,payment_fee,local_transport_cost,risk_flags,booking_party,url,notes

リスクフラグはセミコロン区切り。例:ota;no_checked_bag;self_transfer;nonrefundable

最終安全確認

「今すぐ予約」を推奨する前に、到達可能であればチェックアウトページまたは公式詳細ページでオプションを確認し、タイムスタンプを記載すること。ログインや個人情報の入力なしに最終チェックアウトに到達できない場合は、その旨を伝え、価格を暫定扱いとすること。

関連スキル