skiplagged-travel-search

Skiplagged 旅行検索

概要

Skiplagged MCP は、旅行検索機能（フライト、日付を柔軟に選べるカレンダー、「行き先をおまかせ」検索、ホテルと客室の詳細、場合によってはレンタカー）を MCP ツールとして提供します。 料金や空席状況を推測せず、Skiplagged ツールを優先して呼び出してください。

前提条件

1. HTTP トランスポートを使用して、MCP クライアントを https://mcp.skiplagged.com/mcp に接続します。
2. ワークフローを実行する前に、ツール一覧を取得し、Skiplagged ツールが表示されることを確認します。
3. 認証は不要として扱います。
4. クライアントごとのセットアップコマンドと使用例については、references/setup.md を参照してください。

---

運用ルール

1）根拠のルール

回答は常にツールの結果に基づけてください。料金、空席状況、ポリシーを捏造したり、推測したりしないでください。

2）ツール呼び出しの規律

• 必要最小限の正しいパラメーターを使用します（ユーザーが求めていない限り、不要なフィルターは避けてください）。
• 可能な場合はIATA 空港コードを優先してください。それ以外の場合は都市名を受け入れ、必要に応じて確認します。
• 対応している場合は**少ない件数（例：3～7件）**に制限し、ユーザーから求められた場合にのみ増やします。
• 必要に応じて複数のツール呼び出しを連鎖させますが、ループは避けてください。ターンごとのツール呼び出し上限を守ります。

3）呼び出し後の検証ループ

各ツール呼び出しの後に、次の手順を実行します。

1. ツールが返した内容を1～2文で要約します（旅行者にとって重要な点：費用、所要時間、乗り継ぎ、主なトレードオフ）。
2. 次の手順を決めます。
   • 続行する（条件を絞り込む、または情報を補足する）
   • 自己修正する（フィルターを緩和する、空港や日付を調整する）
   • または、的を絞った確認質問を1つする

4）失敗時の対応（結果が空、または役に立たない場合）

結果が空、または曖昧な場合：

• その旨を明確に伝えます。
• 最善の次の手順を提案します（日付の範囲を広げる、近隣の空港を使う、乗り継ぎ1回を許容する、時間帯を調整する、「行き先をおまかせ」検索を試す、または旅行計画をホテル優先に切り替える）。
• 結果がない場合以外の失敗については、https://skiplagged.com を直接利用するよう提案します。

5）出力スタイル（旅行者中心）

簡潔で実用的な回答にします。

• 節約額、経路に関する情報、主なトレードオフ（乗り継ぎ回数と所要時間と料金）を強調します。
• 結果をすべて列挙するのではなく、短い候補リスト（通常は3～7件）を提示します。

---

ツールの確認（必須、デプロイ環境の違いにも安全に対応）

デプロイ環境によってツール名が変更されたり、新しいツールが追加されたりする場合があります。ワークフローを実行する前に、次の手順を実施します。

1. 接続先の Skiplagged MCP サーバーで利用可能なツール一覧を取得します。
2. 各機能に最適なツールを特定します。
   • フライト検索
   • 日付を柔軟に選べるカレンダー
   • 行き先をおまかせ検索
   • ホテル検索
   • ホテルの詳細
   • （任意）レンタカー

マッピングの慣例（一般的なものであり、保証されません）： ツール名は sk_ で始まることがよくあります。

一般的な機能 → 代表的なツール名（参考）

• フライト検索 → sk_flights_search
• 出発日の柔軟なカレンダー → sk_flex_departure_calendar
• 帰着日の柔軟なカレンダー → sk_flex_return_calendar
• 行き先をおまかせ検索 → sk_destinations_anywhere
• ホテル検索 → sk_hotels_search
• ホテルの詳細 → sk_hotel_details

ツール一覧が異なる場合は、最も近い機能のツールを使用し、以下のワークフローは変更せずに進めてください。

---

聞き取りチェックリスト（必要なことだけ尋ねる）

不足している重要な入力項目だけを抽出するか、確認します。

• ルートの希望：特定のルート（出発地 -> 目的地）か、行き先を柔軟に選ぶ「おまかせ」か。
• 日付：確定した日付、または柔軟な期間と旅行日数。
• 旅行者：大人／子ども／乳幼児の人数と、通常設定以外の客室クラス。
• 条件：予算、乗り継ぎ回数、所要時間の上限、時間帯、航空会社の希望。
• 宿泊の希望（該当する場合）：ホテルの場所、日付、宿泊人数、必要な設備。

ワークフロー

ワークフロー A — 標準的なフライト検索（片道または往復）

ユーザーが場所間の具体的なフライトを希望している場合に使用します。

優先ツール → フォールバック

• 優先：sk_flights_search

手順

1. 場所を正規化します。
   • ユーザーが都市／地域を指定した場合、結果に大きく影響するなら、利用可能な空港を確認します（複数の空港がある都市圏）。
2. 次の情報を指定して、フライト検索ツールを呼び出します。
   • 出発地、目的地
   • 出発日（往復の場合は帰着日も）
   • 乗客数、客室クラス（指定がなければデフォルトを使用）
   • ユーザーが希望したフィルターのみ（乗り継ぎ回数、時間帯、航空会社の希望）
3. 結果を後処理します。
   • 上位の結果を最安値、最速、乗り継ぎ最少に分類します。
   • 料金、乗り継ぎ回数、所要時間、特筆すべき注意点（夜間の乗り継ぎ、長時間の乗り継ぎ）を含めて、3～7件の候補を提示します。
4. 結果の範囲が広すぎる場合：
   • 質問を1つだけ絞って尋ねる（例：「乗り継ぎ1回を許容しますか？」）か、妥当なデフォルトを適用して、その旨を伝えます。

---

ワークフロー B — 日程に柔軟性がある場合／運賃カレンダー

ユーザーが「X日頃」「日程は柔軟」「最安の日」などと言った場合に使用します。

優先ツール → フォールバック

• 優先：sk_flex_departure_calendar と sk_flex_return_calendar

手順

1. 目標の日付／期間を中心に、出発日カレンダーツールを呼び出します。
2. 往復の場合：
   • ユーザーの意図に合った旅行期間（または帰着日の範囲）を使用します（例：「3～5泊」）。
   • 最適な帰着日を調べるため、帰着日カレンダーツールを呼び出します。
3. 要約します。
   • 最も安い出発日
   • 最も安い往復日程の組み合わせ（対応している場合）
   • 条件（週末、時間帯、予算）に合った日程を2～4件提案します。

---

ワークフロー C — 「どこでも」行き先の検索

行き先に柔軟性がある場合（「暖かい場所」「どこでもいいので安いところ」など）に使用します。

優先ツール → フォールバック

• 優先：sk_destinations_anywhere

手順

1. 次の情報を確認します。
   • 出発地
   • 日付／期間（または月）
   • 条件（予算、最大飛行時間、直行便のみ、地域／気候）
2. 行き先検索ツールを呼び出します。
3. 次の情報とともに、5～12件の行き先を提示します。
   • 行き先、最安運賃、提案日程／期間（返された内容に応じて）
   • ユーザーの条件に沿った、理由を1行で説明
4. ユーザーが行き先を選んだら、ワークフロー A に移行して予約可能な旅程を検索します。

---

ワークフロー D — ホテルと客室の詳細

ユーザーがホテルや宿泊先を尋ねた場合、または旅行計画をまとめて立てたい場合に使用します。

優先ツール → フォールバック

• 優先：sk_hotels_search、続いて sk_hotel_details
• フォールバック：ホテル一覧と、客室／ポリシーの内訳を個別に提供する任意のツール

手順

1. 次の情報を指定して、ホテル検索ツールを呼び出します。
   • 場所、日程、部屋数／宿泊人数
   • 希望されたフィルターのみ（価格上限、評価、アメニティ）
2. 次の情報を含めて、5～10件の候補を提示します。
   • 合計料金／1泊あたりの料金（返された内容に応じて）、評価、主なアメニティ、エリア／近隣地域（返された場合）
3. ユーザーがホテルを選んだとき（または「最もお得なもの」を尋ねたとき）は、ホテル詳細ツールを呼び出します。
4. 客室の選択肢を要約します。
   • 客室タイプ、キャンセルポリシー、含まれるもの（朝食）、合計料金（返された内容に応じて）
   • トレードオフを強調します：返金不可か変更可能か、手数料、価格に対する価値の違い。

---

ワークフロー E — レンタカー（利用可能な場合）

ユーザーがレンタカーを希望する場合に使用します。

優先ツール → フォールバック

• 優先：サーバーのツール一覧にある、説明からレンタカー検索ツールだと分かるツール

手順

1. 貸出／返却場所と時間、および条件（車種クラス、必要な場合は運転者の年齢）を確認します。
2. レンタカー検索ツールがある場合は呼び出します。
3. 合計料金、車種クラス、会社、関連するポリシー（返された内容に応じて）を含めて、3～7件の候補を提示します。

---

計画の進め方（旅行全体の旅程の場合）

ユーザーが「旅行を計画して」と依頼した場合：

1. フライト（または「どこでも」行き先の検索）を起点に、行き先／日程／費用を決めます。
2. 選択した行き先と日程に合わせてホテルを追加します。
3. 必要で、対応している場合はレンタカーを追加します。
4. トレードオフを明確にしたうえで、2～3種類のパッケージ（例：「最安」「バランス重視」「最も便利」）を提示します。

---

信頼性と透明性に関する注意事項

• 価格や空席状況は急速に変化します。結果はツールを呼び出した時点での情報として扱い、リンクが提供されている場合は、ユーザーにそのリンクから利用条件を確認するよう促してください。
• 隠れ都市型の旅程が表示された場合は、一般的な制約やトレードオフ（特に手荷物や乗り継ぎ便に乗り遅れた場合の影響）を明確に伝えてください。過度に推奨せず、注意事項を明示したうえで選択肢として提示してください。

---

トラブルシューティング（ループを避ける）

• 呼び出しに失敗した場合、または結果が空の場合：
  • 条件を広げて再試行するのは最大1回にしてください（例：1回の乗り継ぎを許可する、時間帯を広げる、近隣の空港を含める）。
  • それでも結果が空の場合は、対象を絞った質問を1つ行い、具体的な代替検索を提案してください。