RollingGo 酒店 CLI

适用范围

✅ 在以下情况使用本技能：

• - 查找候选酒店： 用户需要按城市、地标、机场或具体地址搜索附近酒店（例如：“查找东京迪士尼附近的酒店”）。
• 多条件精准筛选： 用户需要在搜索时结合自然语言意图，并严格限制入离日期、入住人数、预算上限、星级区间或距离范围。
• 基于标签与品牌匹配： 用户想寻找包含特定设施或属于特定品牌的酒店（如“亲子友好”、“包含早餐”、“万豪”等），技能可先查询标签库以进行精准筛选。
• 查询房型与实时报价： 用户想深入了解某家具体酒店（通过 hotelId）的可用房型、实时价格、退款政策或具体配置。
• 酒店对比与评估： 用户需要基于真实的结构化数据和当前报价，在多个候选酒店中进行对比分析。
• 酒店预订： 用户选定酒店想要完成预订时。可提取并提供结果中的预订 URL 或酒店主页链接，引导用户直接点击完成购买。

❌ 以下情况不适用：

• - 用户询问非酒店类的旅游预订业务（如机票、火车票、接送机、租车等）。

API Key

解析顺序：--api-key 参数 → RollingGo_API_KEY 环境变量。

还没有 Key？前往申请：https://mcp.agentichotel.cn/apply

运行环境

根据用户环境选择，加载对应的参考文件，并在整个会话中保持一致。

• - npm、npx、Node 或无明确偏好： 加载 references/rollinggo-npx.md
• uv、uvx、PyPI 或 Python： 加载 references/rollinggo-uv.md
• 一致性检查或对比： 同时加载两个参考文件

未明确指定时默认使用 npm/npx（跨环境兼容性更好）。

版本新鲜度（始终使用最新版）

本技能默认策略：每次执行都使用最新发布版本。

• - npm/npx： INLINECODE6
• uvx： INLINECODE7

如果使用已安装命令而不是临时执行，先升级再运行：

• - npm 全局： INLINECODE8
• uv 工具： INLINECODE9

主要工作流

除非用户已经把问题限定在某个具体步骤，否则按顺序执行：

1. 1. 明确需求：目的地、日期、晚数、入住人数、预算、星级、标签、距离
2. 如果需要标签筛选 → 先执行 hotel-tags 获取有效标签字符串
3. 执行 search-hotels → 解析 JSON → 提取 INLINECODE12
4. 执行 hotel-detail --hotel-id <id> 查询房型和价格
5. 如果结果不理想 → 放宽筛选条件后重新搜索

常用命令速查

CODEBLOCK0

关键规则

• - --place-type 必须使用 rollinggo search-hotels --help 里显示的精确值
• INLINECODE16 格式：最小值,最大值，如 INLINECODE18
• INLINECODE19 只允许用于 search-hotels；hotel-detail 和 hotel-tags 会拒绝该参数
• INLINECODE23 的数量必须与 --child-age 参数的个数一致
• INLINECODE25 必须晚于 INLINECODE26
• 有 hotelId 时优先使用 --hotel-id，不要依赖 INLINECODE29

输出说明

• - stdout → 结果数据（默认 JSON）
• stderr → 仅错误信息
• 退出码 0 成功 · 1 HTTP/网络失败 · 2 CLI 参数校验失败
• 结果中包含预订 URL 与酒店详情页链接，可供下游直接使用

无结果时的放宽策略

按顺序尝试：移除 --star-ratings → 增大 --size → 增大 --distance-in-meter → 移除标签筛选 → 放宽日期或预算