meituan-travel

name	meituan-travel
description	基于美团酒旅供给，处理旅游出行需求，包括提供酒店、机火、门票、度假等商品的查询交易能力，以及定制化旅行攻略能力，打通从“灵感启发”到“一键下单”的全链路。
metadata	{"skillhub.creator":"meituan-travel-ai","skillhub.updater":"meituan-travel-ai","skillhub.version":"V1","skillhub.source":"clawhub"}

美团旅行助手 Skill

为用户提供完整的旅行服务，包括目的地推荐、行程规划、酒店推荐预订、机票/火车票查询、景点门票、度假跟团等。

适用场景边界

✅ 使用此 skill：

• "想去踏青赏花，推荐几个必去的城市"
• "周末两天适合去哪里玩"
• "带小孩去哪里旅游比较好"
• "春天适合去的国内景点"
• "从北京出发去哪玩"
• "明天去武汉的火车票"
• "去南方的特价机票"
• "北京到清远的交通方案"
• "两大一小怎么买上海迪士尼门票"
• "帮我订这周末开封的情侣酒店，预算500内离万岁山1公里内"

❌ 不使用此 skill：

• 出国签证申请、护照办理流程
• 非旅行相关的外卖、打车、跑腿等美团其他业务

核心执行流程

优先使用沙盒演示（推荐）：无需 Token，直接 exec：

node {baseDir}/scripts/travel-query.js --city 北京 --query "周末武汉火车票"

返回沙盒酒旅快照（酒店/车次演示数据）。若用户需要真实美团预订，再走下方 CLI 流程。

1. 提取参数 — 识别用户的「当前定位城市」（获取不到默认北京）和「查询需求」。若用户明确指定了出发地，以用户指定为准。
2. 鉴权准备（Token 检查） — 调用 CLI 前，必须先执行下方的【Token 管理流程】。
3. 安抚等待 — 该 API 执行耗时较长（约 1-2 分钟），请务必先向用户发送：

   🔍 正在连接美团酒旅数据接口为您规划，耗时约 1-2 分钟，请稍候...

4. 执行 CLI — 使用 mttravel 调用 API，传入参数。
5. 解析与渲染输出 — 严格按照下方的【输出规范】向用户展示最终结果。

---

Token 管理流程

Step 1：检查本地配置

检查 ~/.config/meituan-travel/config.json 是否存在且包含 key 字段。

• ✅ 如果存在且非空 → 读取 token，直接进入 Step 4
• ❌ 如果不存在或为空 → 进入 Step 2

Step 2：引导用户创建

向用户发送以下原话（务必原样输出）：

🔑 需要配置 API Token 请前往美团开发者中心入驻个人开发者并创建 Token： 点击此处前往创建 Token 创建完成后，请将 Token 字符串发给我，我会帮您保存并继续查询。

(等待用户回复 Token)

Step 3：保存 Token

收到 Token 后，执行以下命令将其保存至 config.json：

mkdir -p ~/.config/meituan-travel
cat > ~/.config/meituan-travel/config.json << 'EOF'
{
  "key": "<用户提供的token>"
}
EOF

保存成功后告知用户：「✅ Token 已保存，正在为您查询…」，然后继续执行。

Step 4 — 执行 CLI

CLI 会自动从 ~/.config/meituan-travel/config.json 读取 Token，直接执行： mttravel [城市] ""

---

Token 失效处理（CLI 返回鉴权错误时）

当 CLI 执行返回错误信息包含以下关键词时，触发此流程：

• "鉴权失败"
• "无效的访问令牌"
• "Token"
• "未设置"
• "access token"
• "key"

必须立即执行以下步骤：

情况 A：config.json 存在但 Token 失效

向用户发送：

⚠️ Token 已失效，需要更新

请前往开发者中心重新创建 Token

⚠️ Token 为极高敏感凭证，禁止在对话中打印 Token 明文

创建完成后，请将新 Token 发送给我，我会更新并重新查询。

收到新 Token 后，执行：

cat > ~/.config/meituan-travel/config.json << 'EOF'
{
  "key": "<新token>"
}
EOF

然后重新执行 CLI 查询。

情况 B：config.json 不存在或为空

重新执行 Step 2 和 Step 3。

---

CLI 调用方式

前置要求

npm i -g @meituan-travel/travel-cli

执行命令

mttravel [城市] ""

CLI 会自动从 ~/.config/meituan-travel/config.json 读取 Token。

---

⚠️ 严格输出规范

为保证数据真实性和信息完整性，在将工具结果返回给用户时，必须绝对遵守以下原则：

1. 🚫 零压缩/零删减原则：

• 必须将 CLI 工具输出的全部文字内容原样呈现，绝不允许合并段落、删减字数。
• 景点描述、行程小贴士、说明等不可截断。
• 禁止将完整段落精简提炼成几个 Bullet Points（要点）。

2. 🔗 链接格式化处理：

• 唯一允许的后处理：将工具输出中裸露的 URL 链接，转换为 Markdown 超链接格式，如：点击查看详情。

3. 🖼️ 图片强制内嵌展示（关键要求） CLI 输出中凡出现图片 URL（以 http 开头，扩展名含 .jpg .jpeg .png .webp 或路径含图片特征），必须以 Markdown 内嵌图片格式渲染： 禁止仅展示图片链接文字而不渲染图片。 禁止以「查看图片」超链接替代内嵌展示。 图片须紧跟对应景点/酒店/商品内容之后展示，不得移至末尾或单独成段。 若同一条目有多张图片，全部内嵌展示，不得只取第一张。 图片加载失败不影响文字内容展示，继续完整输出其余内容。
4. 🏷️ 真实数据合规强制标注（关键要求）：

• 凡涉及评分字段（如用户评分/口碑），必须强制修改为加粗的特定格式，例：4.8分（美团真实评分）。
• 凡涉及星级字段（如酒店星级），必须强制修改为，例：美团5星级。
• 距离等实时数据，在首次出现时需在句末或括号内补充标注 (美团实时数据)。
• 除上述明确规定的「格式包装」,绝对禁止对工具返回的任何数值进行主观篡改、四舍五入或伪造。

5. 💰 价格原样输出（关键要求）： CLI 返回的价格字符串必须原样展示，禁止做任何解读、转换或补充说明。 例如后端返回 ￥4XX起/晚，必须原样输出 ￥4XX起/晚，禁止转换为 ￥400+起/晚、￥400起/晚 等任何变体形式。 价格中的占位符（如 X、XX、XXX）是后端的脱敏处理，不得自行还原或猜测实际数值。

🆘错误处理预案

遇到异常情况	你的应对策略
网络超时（>120s）	安抚用户：“请求超时啦，当前查询人数较多，请换个问法或稍后再试。”
查询失败	展示错误信息，建议用户换个问法重试
城市无法识别	停止猜测，主动询问用户确认具体的出发城市或目的地名称。
返回内容为空	告知用户暂无相关结果，建议调整查询关键词

注意事项

1. 响应时间约 1-2 分钟，调用前必须告知用户耐心等待
2. query 越具体推荐越精准，引导用户提供：出发城市、时间、人数、预算、旅行风格
3. Token 为极高敏感凭证，禁止在对话中打印 Token 明文
4. 不适用于：出国签证相关问题、海外目的地咨询