途牛 CLI 概述

途牛 CLI 是将途牛开放平台旅行服务封装而成的命令行工具，支持通过 Shell 命令调用门票、酒店、机票、火车票、邮轮、度假产品等旅行服务，适用于 AI Agent 集成、自动化脚本及本地调试场景。

术语约定

全文使用以下统一术语，阅读时请留意：

术语	说明
命令（command）	`tuniu` 的一级能力入口，如 `list`、`call`、`schema`
服务（server）	业务域标识，如 `ticket`、`hotel`、`flight`、`train`、`cruise`、`holiday`
工具（tool）	服务下可调用的方法，如 `query_cheapest_tickets`、`searchCruiseList`、`searchHolidayList`
工具输入参数（args）	通过 `-a/--args` 传入的 JSON 字符串
Schema	工具能力定义，包含工具列表、参数结构、必填项
Skill	本文提到的 Skill 均指 `tuniu-cli` 对应的 `SKILL.md`

🚀 统一入口：使用同一套命令（list/call/health/schema）调用不同业务服务，减少"每个服务一套 SDK/调用方式"的维护成本，便于 Agent 和自动化脚本快速复用。
🔐 API Key 认证：通过环境变量 TUNIU_API_KEY 注入凭证，避免在代码中硬编码密钥，降低泄露风险；同时便于在本地、CI、容器环境统一管理认证。
📦 标准协议：底层兼容 JSON-RPC 2.0，输出支持 JSON / Table / YAML；其中 JSON 适合 LLM/Agent 解析，Table 适合人工排查，兼顾"机器可读 + 人可读"。
🤖 AI Agent 动态集成：可通过 tuniu schema --output json 动态获取工具能力，通过 tuniu discovery 子命令刷新/查看服务状态，帮助 Agent 在运行时适配新增服务。
🧩 支持 Skill 分发与安装：内置 SKILL.md 会在 npm 安装时自动检测并安装到现存的 Agent 目录，一键完成 Skill 注册；也可通过 tuniu skill install 显式安装/更新。
🐳 安装便捷灵活：支持 npm install -g、npx 安装，适合个人开发、团队协作和生产部署场景。

若你的 Agent 运行环境支持安装 Skill，可优先查看 tuniu-cli Skill 说明 并结合其中提供的 tuniu-cli skill 使用。

对用户而言：可直接用自然语言提出酒店、机票、门票、火车票、邮轮、度假产品（跟团/自助游/自驾游/当地游等）相关需求，由 Agent 自动选择合适的 tuniu 命令执行。
对 Agent 而言：该 skill 已封装常见意图识别、服务选择、命令模板、动态发现和注意事项，让 Agent 直接基于自然语言旅行需求，自动选择 ticket、hotel、flight、train、cruise、holiday 等服务并调用对应 CLI 命令。
对接方式上：skill 底层仍通过 tuniu-cli 调用途牛服务，因此仍需先安装 CLI 并配置 TUNIU_API_KEY。