flyai

FlyAI — 旅行、航空券、ホテルの検索と予約

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

クイックスタート

1. CLI をインストール：npm i -g @fly-ai/flyai-cli
2. セットアップを確認：flyai 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）：ホテル、航空券、アトラクションのチケット、パフォーマンス、スポーツイベント、文化体験を対象に、自然言語で一括検索します。
  • ホテルパッケージ：追加サービスがセットになった宿泊プランです。
  • 航空券パッケージ：追加サービスがセットになった航空券です。
• AI 検索（ai-search）：ホテル、航空券などを意味に基づいて検索します。自然言語や複雑な検索意図を理解し、精度の高い結果を提供します。

カテゴリー別検索

• 航空券検索（search-flight）：詳細な比較に適した、構造化された航空券の検索結果を取得します。
• ホテル検索（search-hotel）：詳細な比較に適した、構造化されたホテルの検索結果を取得します。
• POI／アトラクション検索（search-poi）：詳細な比較に適した、構造化されたアトラクションの検索結果を取得します。
• 列車検索（search-train）：詳細な比較に適した、構造化された列車チケットの検索結果を取得します。
• Marriott ホテル検索（search-marriott-hotel）：詳細な比較に適した、Marriott グループのホテルの構造化された検索結果を取得します。
• Marriott ホテルパッケージ検索（search-marriott-package）：詳細な比較に適した、Marriott グループのホテルパッケージ商品の構造化された検索結果を取得します。

リファレンス

コマンドの詳細なドキュメントは 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}

最終的にユーザーへ表示する内容では、必ず表示ルールに従ってください。