核心用法
途牛酒店助手(tuniu-hotel)是一款面向酒店预订场景的MCP技能,通过exec执行curl调用途牛酒店MCP服务,实现酒店搜索、详情查询与在线下单三大核心功能。用户需先在途牛开放平台注册获取API Key完成授权。
搜索功能支持按城市、入住/离店日期(YYYY-MM-DD格式)进行酒店检索,返回酒店列表含名称、星级、评分、最低价格、地址等关键信息,并附带queryId支持翻页浏览。详情功能通过hotelId或hotelName调取酒店完整信息,包含房型列表、实时报价、设施政策及关键的preBookParam预订参数。下单功能需在获取酒店详情后执行,自动验价并生成订单,返回订单号、确认号及支付链接。
显著优点
1. 权威供应链:背靠途牛旅游网(纳斯达克上市OTA),酒店库存覆盖国内主要商旅及旅游城市,价格与房态实时同步
2. 全流程闭环:从搜索、比价到下单支付一气呵成,无需跳转外部平台
3. 翻页机制优化:基于queryId的分页设计避免重复传参,提升多轮对话体验
4. 自动验价:下单前自动校验报价有效性,降低因价格变动导致的下单失败
潜在局限
1. 依赖外部认证:必须持有途牛开放平台API Key,个人开发者注册门槛较高
2. 地域限制:主要覆盖中国大陆酒店资源,海外酒店支持有限
3. 日期刚性:强制要求YYYY-MM-DD格式日期,自然语言日期(如"明天""下周")需前置转换
4. 无订单管理:仅支持创建订单,不支持取消、修改、查询历史订单等售后操作
适合人群
- 差旅出行频繁的商务人士
- 规划国内旅行的自由行游客
- 需快速比价并完成预订的效率型用户
- 已持有途牛开放平台开发者资质的企业/个人
常规风险
1. 密钥泄露风险:TUNIU_API_KEY在curl请求头中传输,若日志配置不当可能导致敏感信息暴露
2. 报价时效性:preBookParam存在有效期,两次调用间隔过长可能导致验价失败需重新获取详情
3. 库存波动:热门日期酒店房态变化快,搜索到下单的短暂窗口期内可能出现无房
4. 支付环节外跳:最终支付需跳转途牛支付页面,存在支付链路中断风险