flyai

FlyAI — 旅行、航班与酒店搜索和预订

使用 flyai-cli 调用飞猪 MCP 服务，满足旅行搜索和预订场景需求。
所有命令都会向 stdout 输出单行 JSON；错误和提示信息会输出到 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）：提供结构化火车票结果，便于深入比较。
• 万豪酒店搜索（search-marriott-hotel）：提供结构化的万豪集团酒店结果，便于深入比较。
• 万豪酒店套餐搜索（search-marriott-package）：提供结构化的万豪集团酒店套餐产品结果，便于深入比较。

参考文档

详细的命令文档位于 references/ 中（每个子命令对应一个文件）：

命令	文档
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}

始终遵循面向最终用户的输出展示规则。