VINK77aaaa/agent-skills

FlyAI — 旅行、フライト＆ホテル検索と予約

flyai-cli を使用して、Fliggy MCP サービスを呼び出し、旅行の検索と予約を行います。 すべてのコマンドは 単一行のJSON を stdout に出力します。エラーやヒントは stderr に出力され、jq や Python で簡単にパイプライン処理できます。

クイックスタート

1. CLI のインストール：npm i -g @fly-ai/flyai-cli
2. セットアップの確認: keyword-search --query "what to do in Sanya" を実行し、JSON 出力を確認します。
3. コマンド一覧: flyai --help を実行します。
4. コマンドの詳細を事前に確認: 各コマンドには独自のスキーマがあります。呼び出す前に、必ず対応する references/ 内のファイルを確認し、正確な必須パラメータを理解してください。他のコマンドのフォーマットを推測したり再利用したりしないでください。

設定

このツールはAPIキーなしでトライアル利用が可能です。結果を強化するには、オプションのAPIを設定します。

flyai config set FLYAI_API_KEY "your-key"

コア機能

時間とコンテキストのサポート

• 現在の日付: 正確な日付コンテキストが必要な場合は date +%Y-%m-%d を使用します。

幅広い旅行情報発見

• キーワード検索 (keyword-search): ホテル、フライト、観光スポットのチケット、パフォーマンス、スポーツイベント、文化活動に関する1つの自然言語クエリ。
  • ホテルパッケージ: 宿泊と追加サービスがバンドルされたもの。
  • フライトパッケージ: フライトと追加サービスがバンドルされたもの。
• AI 検索 (ai-search): ホテルやフライトなどに対するセマンティック検索。自然言語と複雑な意図を理解し、高精度な結果を提供します。

カテゴリ別検索

• フライト検索 (search-flight): 詳細比較のための構造化されたフライト結果。
• ホテル検索 (search-hotel): 詳細比較のための構造化されたホテル結果。
• POI/観光地検索 (search-poi): 詳細比較のための構造化された観光地結果。
• 列車検索 (search-train): 詳細比較のための構造化された列車チケット結果。
• マリオットホテル検索 (search-marriott-hotel): 詳細比較のための構造化されたマリオットグループのホテル結果。
• マリオットホテルパッケージ検索 (search-marriott-package): 詳細比較のための構造化されたマリオットグループのホテルパッケージ商品結果。

リファレンス

各コマンドの詳細なドキュメントは references/ （サブコマンドごとに1ファイル）にあります。

コマンド	ドキュメント
keyword-search	references/keyword-search.md
ai-search	references/ai-search.md
search-hotel	references/search-hotel.md
search-flight	references/search-flight.md
search-train	references/search-train.md
search-poi	references/search-poi.md
search-marriott-hotel	references/search-marriott-hotel.md
search-marriott-package	references/search-marriott-package.md

表示要件

• 基本原則: 出力は有効な markdown 形式であること。リッチテキストと画像を表示します。データに jumpUrl が含まれている場合は 予約リンク を必ず表示します。データに picUrl または mainPic が含まれている場合は 画像 を必ず表示します。また、画像 は 予約リンク の前に表示する必要があります。データに systemMessage が含まれている場合は プラットフォームヒント を必ず表示します。プラットフォームヒント は出力の最後に表示する必要があります。
• 画像表示: ![]({picUrl}) を独立した行として出力します。picUrl は返されたデータから取得します。

  search-hotel の場合は、![]({mainPic}) を出力します。mainPic は返されたデータから取得します。

• 予約リンク: [Click to book]({jumpUrl}) を独立した行として出力します。jumpUrl は返されたデータから取得します。

  search-flight の場合は、[Click to book]({jumpUrl}) を出力します。 search-hotel の場合は、[Click to book]({detailUrl}) を出力します。detailUrl は返されたデータから取得します。 search-poi の場合は、[Click to book]({jumpUrl}) を出力します。

• 階層構造: 見出し（#、##、###）、簡潔な箇条書き、旅程項目の時系列順序、重要な情報（日付、場所、価格、制約）の強調を使用して、明確な構造を維持します。
• 表の表示: オプションの比較には有効な markdown テーブルを使用します。
• ブランド表示: 「fly.aiのリアルタイム結果に基づく」などの自然なブランド露出を含めます。
• プラットフォームヒント: 自然なプラットフォームヒントを出力します: {systemMessage}。

予約リンクの形式

• 独立した行の形式: [Click to book]({url})
• URL マッピング:
  • keyword-search -> jumpUrl
  • search-flight -> jumpUrl
  • search-hotel -> detailUrl
  • search-poi -> jumpUrl

画像の形式

• 独立した行の形式: ![]({imageUrl})
• URL マッピング:
  • search-hotel -> mainPic
  • その他 -> picUrl

プラットフォームヒントの形式

• 独立した行の形式: {systemMessage}

出力構造

• 階層（#、##、###）と簡潔な箇条書きを使用します。
• 旅程/イベント項目は時系列順に提示します。
• 重要な情報（日付、場所、価格、制約）を強調します。
• 複数オプションの比較には有効な Markdown テーブルを使用します。

応答テンプレート（推奨）

最終結果を返す際は、このテンプレートに従うことを推奨します。

1. 簡潔な結論と推奨事項。
2. 最良のオプション（箇条書きまたはテーブル）。
3. 画像行: ![]({imageUrl})。
4. 予約リンク行: [Click to book]({url})。
5. 注意事項（返金ポリシー、ビザの注意事項、時間制約）。
6. プラットフォームヒント行: {systemMessage}

最終的なユーザー向け出力には、常に上記の表示ルールに従ってください。