ctrip-flight-search

Ctrip のフライト検索スキル

機能概要

このスキルは、実際に検証されたブラウザー操作フローに基づき、Ctrip のフライト検索を完全に自動化する機能を提供します。以下の機能に対応しています。

• 片道フライト検索：指定した日に出発地から目的地までのフライトを検索します
• 往復フライト検索：指定した往復日のフライトを検索します（対応を検証済み）
• 複数都市への対応：中国語の都市名と空港コードを入力できます
• 複数都市での汎用性：任意の都市の組み合わせ（広州→成都、北京→上海など）への対応を検証済みです
• 国際線検索：国際路線の検索に対応しています（上海→東京、北京→ソウルなど）
• 日付範囲：YYYY-MM-DD 形式の日付を入力できます
• エラー処理：要素が表示されない場合やページが変化した場合などの例外を処理する仕組みを備えています

使用シーン

ユーザーが以下を必要とする場合：

• 特定の日付のフライト情報を検索する
• フライトの料金や時刻表を取得する
• フライト検索のプロセスを自動化する
• Ctrip からフライトデータを抽出する
• 異なる都市間でフライト検索が可能か確認する

コア操作の SOP フロー

基本的な検索フロー

1. Ctrip のホームページに移動：navigate → https://www.ctrip.com
2. フライト検索ページに移動：backbone → 航空券ボタンを特定 → click
3. 出発地を入力：type → 都市名 → search → 空港を選択 → click
4. 目的地を入力：search → 目的の都市 → click
5. 日付を設定：日付入力欄が正しく設定されていることを確認
6. 検索を実行：press → Enter（優先する方法）、または検索ボタンをクリック

重要な操作のポイント

出発地／目的地の入力

• まずtypeを使用して、入力欄に都市名（「北京」「上海」「広州」「成都」など）を入力します
• システムが選択肢のドロップダウンリストを自動的に表示します
• searchを使用して、具体的な空港の選択肢（「北京（大興国際空港）（PKX）」「成都（双流国際空港）（CTU）」など）を検索します
• clickを使用して、目的の空港を選択します
• 複数都市での汎用性：このスキルは、一線・二線・三線都市を含む任意の中国語の都市名の組み合わせに対応することを検証済みです

検索の実行方法

• 優先する方法：press + Enterでフォームを送信します（オーバーレイによる操作阻害を回避でき、複数都市のシナリオで有効性を検証済みです）
• 代替方法：Enter キーが機能しない場合は、searchで検索ボタンを探してclickします

エラー処理の仕組み

• 要素が表示されない場合：マウスクリックの代わりにキーボード操作を試します（複数都市でのテストでは、キーボード操作のほうが安定していました）
• ページ構造の変化：操作のたびにbackboneまたはsearchを再度使用して、最新の要素参照を取得します
• 入力に失敗した場合：入力を再試行するか、別の都市名の形式を使用します
• 動的な要素参照の無効化：複数都市でのテストでも広く発生することが確認されています。操作の前に毎回、要素を特定し直すことを推奨します

対応するパラメーター形式

出発地／目的地

• 中国語の都市名：「北京」「上海」「広州」「成都」「深圳」「杭州」など（中国国内の主要都市に対応）
• 国際都市名：「東京」「ソウル」「シンガポール」「バンコク」「パリ」「ロンドン」など（主要な国際都市に対応）
• 空港コード：「PEK」「SHA」「CAN」「CTU」「HND」「ICN」など（三字コード）
• 空港の正式名称：「北京首都国際空港」「上海虹橋国際空港」「広州白雲国際空港」「成都双流国際空港」「東京羽田空港」「ソウル仁川国際空港」など

日付形式

• 標準形式：YYYY-MM-DD（例：2026-03-20）
• 対応範囲：当日および未来の日付

フライトの種類

• 片道：デフォルトで対応
• 往復：復路の日付パラメーターに対応（検証済み）
• 複数区間：複雑な検索シナリオ（今後拡張予定）

検証済みの操作範囲

✅ Ctrip の公式サイトにアクセスし、フライト検索ページに移動する
✅ 出発地の都市名を入力し、該当する空港を選択する
✅ 目的地の都市名を入力し、該当する空港を選択する
✅ 検索日を設定する
✅ フライト検索を実行し、結果ページへの遷移に成功する
✅ ページの動的な変化に対応し、要素参照を更新する
✅ 複数都市での汎用性の検証：広州（CAN）→成都（CTU）、北京（PEK）→上海（SHA）など、さまざまな都市の組み合わせでテストに成功
✅ キーボード操作の安定性：複数都市でのテストにより、Enter キーで送信する方法の信頼性を検証
✅ 国際線検索の検証：上海（SHA）→東京（HND）の国際路線のテストに成功し、国際都市の認識と検索フローの汎用性を検証

参考ドキュメント

詳細な操作ガイドと SOP フローについては、references/操作指南.mdを参照してください。

注意事項

1. ページの読み込み時間：Ctrip のページは読み込みに時間がかかる場合があるため、操作の合間に適宜待機してください
2. ネットワーク環境：ネットワーク接続が正常であることを確認してください。中国国内では Ctrip に安定してアクセスできます
3. ブラウザーの互換性：最新のブラウザー向けの自動化ツールに基づいているため、ツールのバージョンに互換性があることを確認してください
4. CAPTCHA の処理：CAPTCHA やログインが求められた場合は、人手による対応が必要です
5. 複数都市でのテスト結果：このスキルは異なる都市の組み合わせでも一貫した動作を示しており、コア操作フローを変更する必要はありません

拡張の方向性

• 往復フライト検索への対応を追加する
• 座席クラスの選択（エコノミークラス、ビジネスクラス、ファーストクラス）に対応する
• 料金の絞り込みと並べ替え機能を追加する
• フライト詳細ページからのデータ抽出に対応する
• 一括検索機能を追加する