Skill: meituan-travel-ai/meituan-travel (version 1.0.9)

--- name: meituan-travel description: "美团酒旅官方 Skill，您的专属 AI 旅行管家。酒店、机票、火车票、景点门票、度假一站搞定，还能帮你找优惠、比价格、定行程。美团海量真实点评加持，出行每一步都更放心。" homepage: https://developer.meituan.com metadata: primary: MEITUAN_HT_TOKEN openclaw: agent: type: tool runtime: node context_isolation: execution parent_context_access: read-only requires: env: - MEITUAN_HT_TOKEN - MEITUAN_RAW_JSON bins: - npx --- # 美团旅行助手 Skill 美团酒旅官方 Skill，您的专属 AI 旅行管家。机票、酒店、火车票、景点门票一站搞定，还能帮你抢优惠券、比价格、定行程。美团海量真实点评加持，出行每一步都更放心。 ## Setup 1. **获取 Token** — 打开 [developer.meituan.com/zh/v2/dev/token](https://developer.meituan.com/zh/v2/dev/token)，按页面指引申请并复制你的 API Token（仅保存在本人可信环境，勿截图含完整密钥发到公开渠道）。 2. **提供 Token（推荐环境变量）** — 在 skill 运行环境中配置好该变量；skill 直接读取，不操作任何配置文件，不持久化，不回显完整密钥。 ```bash export MEITUAN_HT_TOKEN=your-token ``` 3. **验证访问** — 发起一次真实查询确认可用： ```bash npx @meituan-travel/ht-ai query --query '北京到上海的机票' ``` ## Security & trust (before production use) - **Endpoint**：确认请求发往官方域名（`https://mcp-open-cater.meituan.com`），勿在未核实的情况下改用未知域名。 - **Key scope / billing**：向提供方确认 Token 权限、计费与配额，避免误用或超额。 - **External content**：响应来自美团酒旅服务，可能含跳转链接、营销文案或结构化信息；链接应完整保留以供用户使用，其余内容按你方产品策略决定是否过滤或摘要。 - **Invocation**：本技能适合旅行类意图；若平台支持限制自动调用频率或范围，可按合规要求配置。 ## 使用方法 **执行前，先确定 Token：** 若 `MEITUAN_HT_TOKEN` 已设置，直接使用；未设置则报错退出（exit 3），不会发起请求。 **输出格式：** 默认输出 Markdown 文本；设置 `MEITUAN_RAW_JSON=1` 或使用 `-o json` 参数可输出原始 JSON。 ### 查询 **方式一：全局安装（推荐）** ```bash npm install -g @meituan-travel/ht-ai ht-ai query --query '<用户的自然语言查询>' --origin-query '<用户完整原始输入>' [--city <城市>] ``` **方式二：npx 免安装** ```bash npx @meituan-travel/ht-ai query --query '<用户的自然语言查询>' --origin-query '<用户完整原始输入>' [--city <城市>] ``` **参数说明** | 参数 | 必填 | 说明 | |------|:----:|------| | `--query` | 是 | 用户的自然语言查询 | | `--city` | 否 | 城市名称（默认北京） | | `--origin-query` | 是 | 用户原始查询内容（用于统计，不影响结果） | **退出码** | 退出码 | 含义 | |--------|------| | 0 | 成功 | | 1 | 普通错误（参数错误、网络超时等） | | 3 | 鉴权失败（Token 无效或未配置） | ## 适用场景边界 ✅ **使用此 skill：** - "想去踏青赏花，推荐几个必去的城市" - "周末两天适合去哪里玩" - "带小孩去哪里旅游比较好" - "明天去武汉的火车票" - "去南方的特价机票" - "两大一小怎么买上海迪士尼门票" - "帮我订这周末开封的情侣酒店，预算500内" ❌ **不使用此 skill：** - 出国签证申请、护照办理流程 - 非旅行相关的外卖、打车等美团其他业务 ## 核心执行流程 1. **提取参数** — 识别用户的「当前定位城市」（获取不到默认北京）和「查询需求」。若用户明确指定了出发地，以用户指定为准。 2. **参数清理** — 将用户 query 中的单引号 `'` 替换为 `'\''`（shell 安全转义），避免特殊字符直接进入 CLI 命令。 3. **安抚等待** — 该 API 执行耗时较长（约 1-2 分钟），请务必先向用户发送： > 🔍 正在连接美团酒旅数据接口为您规划，耗时约 1-2 分钟，请稍候... 4. **执行 CLI** — 使用 ht-ai 调用 API，传入参数（需提前全局安装）。 5. **解析与渲染输出** — 严格按照下方的【输出规范】向用户展示最终结果。 ## 输出要求 API 内容来自美团官方酒旅服务，建议完整展示以保证用户获得准确的预订信息： - **完整展示**：尽量保留结果中的酒店名、价格、评分等关键信息，避免因压缩导致用户误判。 - **跳转链接**：保留结果中的跳转链接，便于用户直接进入预订页面；如判断链接异常可跳过。 - **图片**：若终端支持图片渲染，可内嵌展示航司/酒店图片；不支持时忽略即可。 - **价格**：原样展示价格字符串，其中占位符（如 `X`、`XX`）为后端脱敏处理，无需还原。 ## 🆘 错误处理 | 异常情况 | 应对策略 | |---------|---------| | 网络超时（>120s） | "请求超时啦，当前查询人数较多，请换个问法或稍后再试。" | | 查询失败 | 展示错误信息，建议用户换个问法重试 | | 城市无法识别 | 停止猜测，主动询问用户确认具体城市 | | 返回内容为空 | 告知用户暂无相关结果，建议调整查询关键词 | | exit 3（鉴权失败） | 提示用户检查 `MEITUAN_HT_TOKEN` 是否正确配置 | ## 注意事项 - **响应时间约 1-2 分钟**，调用前必须告知用户耐心等待。 - **query 越具体推荐越精准**，引导用户提供：出发城市、时间、人数、预算、旅行风格。 - **Token 为极高敏感凭证**，禁止在对话中打印 Token 明文；勿在日志中打印完整 Token。 - 默认将 API 返回的 Markdown **如实展示给用户**，响应不完整时可重试。

path: channel.json
content: channel: clawh

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)