途牛 CLI 概述

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

术语约定

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

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

🚀 统一入口：使用同一套命令（list/call/health/schema）调用不同业务服务，减少"每个服务一套 SDK/调用方式"的维护成本，便于 Agent 和自动化脚本快速复用。
🔐 多种认证方式：优先支持 OAuth 全服务授权，也可通过环境变量 TUNIU_AUTH_TYPE 选择 auto、oauth 或 apiKey；API Key 可作为无浏览器环境下的兜底方案。
📦 标准协议：底层兼容 JSON-RPC 2.0，输出支持 JSON / Table / YAML；其中 JSON 适合 LLM/Agent 解析，Table 适合人工排查，兼顾"机器可读 + 人可读"。
🤖 AI Agent 动态集成：可通过 tuniu schema --output json 动态获取工具能力，通过 tuniu discovery 子命令刷新/查看服务状态，帮助 Agent 在运行时适配新增服务和认证配置。
🧩 支持 Skill 分发与安装：内置 skill/（含 SKILL.md 与 references/）会在 npm 安装时自动检测并安装到现存的 Agent 目录，一键完成 Skill 注册；也可通过 tuniu skill install 显式安装/更新。
⬆️ 一键更新：tuniu update 可升级 CLI，并同步刷新本机已安装的 Agent Skill。
🐳 安装便捷灵活：支持 npm install -g、npx 安装，适合个人开发、团队协作和生产部署场景。

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

对用户而言：可直接用自然语言提出酒店、企业商旅酒店、机票、门票、火车票、邮轮、度假产品（跟团/自助游/自驾游/当地游等）相关需求，由 Agent 自动选择合适的 tuniu 命令执行。
对 Agent 而言：该 skill 已封装常见意图识别、服务选择、命令模板、动态发现、OAuth / API Key 认证和注意事项，让 Agent 直接基于自然语言旅行需求，自动选择服务并调用对应 CLI 命令。
对接方式上：skill 底层仍通过 tuniu-cli 调用途牛服务，因此仍需先安装 CLI；首次使用推荐执行 tuniu auth login 完成 OAuth 授权，无法使用浏览器时再配置 TUNIU_API_KEY；企业商旅酒店需配置 TUNIU_TTMS_API_KEY。
升级方式：执行 tuniu update 一键更新 CLI 与已安装 Skill。