القائمة
途牛火车票助手 - 通过 exec + curl 调用 MCP 实现车次列表搜索、查询车次详情、预订下单。适用于用户查询车次列表、查询车次详情或提交火车票订单时使用。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/LeoYeAI/openclaw-master-skills --skill tuniu-trainيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
A curated collection of 2409+ best OpenClaw skills — AI tools, productivity, marketing, frontend, mobile, backend, DevOps and more. Weekly updated by MyClaw.ai — Powered by MyClaw.ai
The ai-image-to-video-generator skill on ClawHub transforms static images into dynamic, motion-rich video content through a conversational interface. Upload any photo or illustration, describe the motion style you want, and receive a polished video output. Ideal for marketers, content creators, and social media managers who need animated visuals without complex software. Supports mp4, mov, avi, webm, and mkv output formats.
Scan any agent skill for security risks before you install or use it. Powered by Tencent Zhuque Lab A.I.G (AI-Infra-Guard). 100% local static analysis — no file contents or credentials leave your device. Compatible with CodeBuddy, Cursor, Windsurf, Claude Code, OpenClaw and more. Triggers on: `这个 skill 安全吗`, `skill 安全扫描`, `检查 skill 安全`, `audit skill`, `scan skill`, `check skill safety`, `analyze skill`, `inspect skill`, `verify skill`, `skill security`, `skill supply chain`. Do NOT trigger for general agent usage, full system health checks, project debugging, or normal development.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | tuniu-train |
| description | 途牛火车票助手 - 通过 exec + curl 调用 MCP 实现车次列表搜索、查询车次详情、预订下单。适用于用户查询车次列表、查询车次详情或提交火车票订单时使用。 |
| version | 1.0.0 |
| metadata | {"openclaw":{"emoji":"🚄","category":"travel","tags":["途牛","火车票","车次详情","下单"],"requires":{"bins":["curl"]},"env":{"TUNIU_API_KEY":{"type":"string","description":"途牛开放平台 API key，用于 apiKey 请求头","required":true}}}} |
当用户查询车次列表、查询具体车次详情或火车票预订时，使用此 skill 通过 exec 执行 curl 调用途牛火车票 MCP 服务。
本 skill 通过 shell exec 执行 curl 向 MCP endpoint 发起 HTTP POST 请求，使用 JSON-RPC 2.0 / tools/call 协议。运行环境必须提供 curl 或等效的 HTTP 调用能力（如 wget、fetch 等可发起 POST 的客户端），否则无法调用 MCP 服务。
预订功能会将用户提供的个人信息（联系人姓名、手机号、乘客姓名、证件号等）通过 HTTP POST 发送至途牛火车票 MCP 远端服务（https://openapi.tuniu.cn/mcp/train） ，以完成火车票预订。使用本 skill 即表示用户知晓并同意上述 PII 被发送到外部服务。请勿在日志或回复中暴露用户个人信息。
apiKey 请求头用户需在途牛开放平台注册并获取上述密钥。
https://openapi.tuniu.cn/mcp/train直接调用工具：使用以下请求头调用 tools/call 即可：
apiKey: $TUNIU_API_KEYContent-Type: application/jsonAccept: application/json, text/event-stream重要：下方示例中的参数均为占位，调用时需根据用户当前需求填入实际值（出发站、出发日期、车次号、出行人、联系方式等），勿直接照抄示例值。
首次查询：必填 departureCityName、arrivalCityName、departureDate（格式 yyyy-MM-dd），非必填 departureTime(出发时间范围,如08:00-12:00)、arrivalTime(到达时间范围,如18:00-20:00)。
入参示例:
{
"departureCityName": "南京",//出发站
"arrivalCityName": "上海",//到达站
"departureDate": "2026-03-20",//出发日期
"departureTime": "08:00-12:00",//出发时间范围
"arrivalTime": "18:00-20:00"//到达时间范围
}
出参示例：
{
"successCode": true,
"data": [
{
"trainNum": "1461",//车次号
"departStationName": "南京",//出发站名称
"destStationName": "上海",//到达站名称
"trainType": "direct",
"departureTime": "2026-03-20 03:04",//出发时间
"arrivalTime": "2026-03-20 06:45",//到达时间
"price": {
"gjrwPrice": "",//高级软卧价格,“”表示无此坐等
"rwPrice": "140.5",//软卧价格
"rzPrice": "",//软座价格
"swzPrice": "",//商务座价格
"tdzPrice": "",//特等座价格
"wzPrice": "",//无座价格
"ywPrice": "94.5",//硬卧价格
"yzPrice": "40.5",//硬座价格
"edzPrice": "",//二等座价格
"ydzPrice": "",//一等座价格
"dwPrice": "",//动卧价格
"ydwPrice": "",//一等卧价格
"edwPrice": ""//二等卧价格
},
"duration": "3时41分",//运行时长
"seatAvailable": {
"gjrwNum": null,//高级软卧余票数量,null表示无此坐等,0表示没有余票,大于0表示有票
"rwNum": 0,//软卧余票数量
"rzNum": null,//软座余票数量
"swzNum": null,//商务座余票数量
"tdzNum": null,//特等座余票数量
"wzNum": null,//无座余票数量
"ywNum": 0,//硬卧余票数量
"yzNum": 0,//硬座余票数量
"edzNum": null,//二等座余票数量
"ydzNum": null,//一等座余票数量
"dwNum": null,//动卧余票数量
"ydwNum": null,//一等卧余票数量
"edwNum": null//二等卧余票数量
}
}
],
"queryId": "65979499413539",//快照id
"totalPageNum": 10//总页数
}
非首次查询：传入首次查询返回的快照id(queryId)和 pageNum（2=第二页，3=第三页…）。用户说「还有吗」「翻页」「下一页」时用queryId + pageNum 再次调用即可。
入参示例：
{
"queryId": "65979499413539",//快照id
"pageNum": 2//页数
}
出参示例：
{
"successCode": true,
"data": [
{
"trainNum": "K1505",//车次号
"departStationName": "南京",//出发站名称
"destStationName": "上海",//到达站名称
"trainType": "direct",
"departureTime": "2026-03-20 18:41",//出发时间
"arrivalTime": "2026-03-20 22:22",//到达时间
"price": {
"gjrwPrice": "",//高级软卧价格,“”表示无此坐等
"rwPrice": "146.5",//软卧价格
"rzPrice": "",//软座价格
"swzPrice": "",//商务座价格
"tdzPrice": "",//特等座价格
"wzPrice": "46.5",//无座价格
"ywPrice": "100.5",//硬卧价格
"yzPrice": "46.5",//硬座价格
"edzPrice": "",//二等座价格
"ydzPrice": "",//一等座价格
"dwPrice": "",//动卧价格
"ydwPrice": "",//一等卧价格
"edwPrice": ""//二等卧价格
},
"duration": "3时41分",//运行时长
"seatAvailable": {
"gjrwNum": null,//高级软卧余票数量,null表示无此坐等,0表示没有余票,大于0表示有票
"rwNum": 4,//软卧余票数量
"rzNum": null,//软座余票数量
"swzNum": null,//商务座余票数量
"tdzNum": null,//特等座余票数量
"wzNum": 0,//无座余票数量
"ywNum": 17,//硬卧余票数量
"yzNum": 0,//硬座余票数量
"edzNum": null,//二等座余票数量
"ydzNum": null,//一等座余票数量
"dwNum": null,//动卧余票数量
"ydwNum": null,//一等卧余票数量
"edwNum": null//二等卧余票数量
}
}
]
}
触发词：查询某日出发某站到某站的火车票
# 首次查询：出发站、到达站、出发日期按用户需求填写（日期格式 yyyy-MM-dd）
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"searchLowestPriceTrain","arguments":{"departureCityName":"<用户指定的出发站>","arrivalCityName":"<用户指定的到达站>","departureDate":"<用户指定的出发日期 yyyy-MM-dd>","departureTime":"<用户指定的出发时间范围,如08:00-12:00>","arrivalTime":"<用户指定的到达时间范围,如18:00-20:00>"}}}'
# 非首次查询：快照id(queryId) + pageNum
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"searchLowestPriceTrain","arguments":{"queryId":"<快照id>","pageNum":2}}}'
入参：departureStationName、arrivalStationName、departureDate（yyyy-MM-dd）、trainNum（车次号，从搜索结果获取）均为必填。
入参示例：
{
"departureStationName": "南京南",//出发站
"arrivalStationName": "上海虹桥",//到达站
"departureDate": "2026-03-20",//出发日期
"trainNum": "G203"//车次号
}
返回：trainInfo（车次详情）、seatInfo（坐等信息，含 resId、price等）。resId、price、departsDate 为下单必填，需保留供 bookTrain 使用。
出参示例：
{
"successCode": true,
"data": {
"isVoucherSaleForDetail": true,
"isVoucherSaleForGrab": "0",
"trainInfo": {
"id": "16203",
"trainId": "16203",//车次id
"trainNum": "G203",//车次号
"trainType": 0,//车次类型;0:高铁;1:城际;2:动车;3:直达;4:特快;5:普快;6:其他
"trainTypeCode": 0,//车次类型code
"trainTypeName": "高铁",//车次类型名称
"departCityId": "1602",//出发城市id
"destCityId": "2500",//到达城市id
"departStationName": "南京南",//出发站名称
"departStationCode": "1175373",//出发站code
"departStationType": "始发",//出发站是否始发;0:始发；1:终点；2:过路
"departStationTypeCode": 0,//出发站是否始发code;0:始发；1:终点；2:过路
"departureCityName": "南京",//出发城市名称
"destStationName": "上海虹桥",//到达站名称
"destStationCode": "1175076",//到达站code
"destStationType": "过路",//到达站是否终点;0:始发；1:终点；2:过路
"destStationTypeCode": 2,//到达站是否终点code;0:始发；1:终点；2:过路
"arrivalCityName": "上海",//到达城市名称
"departTime": "06:32",//出发时间
"arriveTime": "07:53",//到达时间
"saleStatus": "在售",//售卖状态;0:在售;1:停售;2:预售
"saleStatusId": 0,//售卖状态id;0:在售;1:停售;2:预售
"duration": "1时21分",//运行时长
"durationDay": 1,//历时天数;1:当天;2:第二天
"departsDate": "2026-03-20",//出发日期
"arriveDate": "2026-03-20",//到达日期
"memoDay": "",
"memoHour": "",
"departureDates": {
"yesterday": "2026-03-19",
"today": "2026-03-20",
"tomorrow": "2026-03-21"
},
"leftNumber": 99,
"seat": "二等座",
"price": 141.0,
"promotionPrice": 141.0,
"resId": 99,
"canGrap": true,
"oneLeftNumber": 0,
"supportSeatSelection": true,
"supportIdCheckin": true,
"supportTransferFlag": false
},
"seatInfo": [
{
"leftNumber": 99,//余票数量
"seatId": 3,//坐等id;0：商务座;1：特等座;2：一等座;3：二等座;4：高级软卧;5：软卧;6：硬卧;7：软座;8：硬座;9：无座;10：动卧;19.一等卧;20.二等卧
"seatName": "二等座",//坐等名称
"price": 141.0,//坐等价格
"adultPrice": 141.0,
"promotionPrice": 141.0,
"resId": 2121337089,//资源id
"seatStatus": "有",//坐等状态
"seatSequence": 0,
"lowestPrice": null,
"isConfigSeat": false,
"configSeatInfo": null,
"isSupportVoucherSection": true,
"trainVoucherInfo": []
},
{
"leftNumber": 0,
"seatId": 2,
"seatName": "一等座",
"price": 238.0,
"adultPrice": 238.0,
"promotionPrice": 238.0,
"resId": 2121337088,
"seatStatus": "",
"seatSequence": 6,
"lowestPrice": null,
"isConfigSeat": false,
"configSeatInfo": null,
"isSupportVoucherSection": false,
"trainVoucherInfo": []
},
{
"leftNumber": 0,
"seatId": 0,
"seatName": "商务座",
"price": 459.0,
"adultPrice": 459.0,
"promotionPrice": 459.0,
"resId": 2121337087,
"seatStatus": "",
"seatSequence": 9,
"lowestPrice": null,
"isConfigSeat": false,
"configSeatInfo": null,
"isSupportVoucherSection": false,
"trainVoucherInfo": []
},
{
"leftNumber": 0,
"seatId": 9,
"seatName": "无座",
"price": 141.0,
"adultPrice": 141.0,
"promotionPrice": 141.0,
"resId": 2121337090,
"seatStatus": "",
"seatSequence": 13,
"lowestPrice": null,
"isConfigSeat": false,
"configSeatInfo": null,
"isSupportVoucherSection": false,
"trainVoucherInfo": []
}
],
"isOpen": 1,
"needAdd": false,
"departureDates": {
"yesterday": "2026-03-19",
"today": "2026-03-20",
"tomorrow": "2026-03-21"
},
"couponsConfig": {
"displaySwitch": true,
"recommendText": "用车特价券售卖"
}
}
}
触发词：查询G203车次详情
# departureStationName、arrivalStationName、departureDate 从搜索结果或用户需求取，trainNum 从搜索结果取
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"queryTrainDetail","arguments":{"departureStationName":"<出发站>","arrivalStationName":"<到达站>","departureDate":"<出发日期 yyyy-MM-dd>","trainNum":"<车次号>"}}}'
前置条件：
searchLowestPriceTrain 获取车次列表信息queryTrainDetail 获取车次详情；从返回的 seatInfo 中选取坐等，拿到 resId、price、，从trainInfo中获取departureDate必填参数：resources(资源信息)、adultTourists（乘客信息）、contact（联系人信息）、acceptStandingTicket(是否接受无座)。
resources 格式：
| 字段 | 类型 | 说明 |
|---|---|---|
| resourceId | long | 资源id |
| departsDate | string | 出发日期 |
| adultPrice | BigDecimal | 价格 |
adultTourists 格式：
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 姓名 |
| psptType | number | 证件类型;1:身份证,;2:护照 |
| psptId | string | 证件号码 |
| isStuDisabledArmyPolice | number | 乘客类型;0:成人 |
| tel | string | 手机号 |
contact 格式：
| 字段 | 类型 | 说明 |
|---|---|---|
| tel | string | 联系人手机号 |
入参示例：
{
"acceptStandingTicket": false,
"adultTourists": [
{
"name": "张宁",//乘客姓名
"psptId": "110101199001014534",//乘客证件号码
"psptType": 1,//证件类型;1:身份证;2:护照
"isStuDisabledArmyPolice": 0,//乘客类型;0:身份证
"tel": "18888888888"//乘客手机号
}
],
"contact": {
"tel": "18888888888"//联系人手机号
},
"resources": [
{
"resourceId": 2107616437,//坐等对应资源id
"adultPrice": 104.5,//坐等对应价格
"departsDate": "2026-03-24"//出发日期
}
]
}
返回：orderId（下单成功的订单号）、orderDetailUrl（订单详情url）。
出参示例：
{
"successCode": true,
"data": {
"orderId": <订单号>,
"orderDetailUrl": "<订单详情url>"
}
}
触发词：预订、下单、订火车票
# resId、price、departureDate 从最近一次 queryTrainDetail 结果取；乘客信息、联系人按用户需求填
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "bookTrain",
"arguments": {
"acceptStandingTicket": false,
"adultTourists": [
{
"isStuDisabledArmyPolice": 0,
"name": "<乘客姓名>",
"psptId": "<乘客证件号码>",
"psptType": <证件类型>,
"tel": "<乘客手机号>"
}
],
"contact": {
"tel": "<联系人手机号>"
},
"resources": [
{
"adultPrice": <坐等对应的价格>,
"departsDate": "<出发日期>",
"resourceId": <坐等对应的资源id>,
"resourceType": 8
}
]
}
}
}'
入参：orderId必填。
入参示例：
{
"orderId": <订单号>
}
返回：successCode（成功标识,true:成功;false:失败）、errorMessage（失败原因）、data(订单详细信息)。
出参示例：
{
"successCode": true,
"data": {
"localProductType": "COMMON",//火车票订单本地产品类型,默认COMMON
"orderId": 1257118322,//订单号
"mainOrderId": null,
"statusName": "已取消",//对客订单状态名;待出票;处理中;待付款;购票成功;取消中;退票中;退票成功;已取消;购票失败;已取纸质票;退票失败
"payStatusName": "未付款",//订单支付状态:未付款;已付款完成;已退款完成
"payStatus": 1,//支付状态;1:待付款;2:等待付款;3:部分付款;4:已付款完成;5:等待退款;6:已退款完成;7:已部分退款;8:已线下退款
"payAmount": 0,//支付金额
"totalPrice": 0,//订单总价
"reducePrice": 0,//立减金额
"travelCouponPrice": 0,//旅游券金额
"bussinessCardPrice": 0,//商旅卡金额
"isAdvancePay": 1,//是否为虚占提前支付订单;0:不是提前支付;1:是提前支付
"isJoinActivity": 0,//是否是参加活动订单;0:没有参加活动;1:参加了24小时抢票赔付活动
"promotionPrice": 0,促销活动金额
"dispatchDeliverPrice": 0,//配送费
"dispatchPurchasePrice": 0,//代购费
"trainOrderType": "单程票",//火车票订单类型
"deliveryType": "自取票",//取票方式
"failReason": "",//失败原因
"addTime": "2026-03-13 13:11:47",//下单时间
"updateTime": "2026-03-13 13:22:42",//更新时间
"clearTime": "2026-03-13 13:41:48",//清位时间
"contact": {
"name": "",
"appellation": null,
"email": "",
"phone": "",
"tel": "18888888888",//联系人手机号
"fabId": null
},
"touristList": [
{
"touristId": 68472893,//订单乘客id
"touristName": "张宁",//乘客姓名
"touristType": 0,//出游人类型;0:成人;1:儿童;5:学生
"psptType": 1,//证件类型;1:身份证;2:因私护照
"psptId": "110101199001014534",//证件号
"birthday": "1990-01-01"//出生日期
}
],
"trainTicketList": [
{
"resourceId": 353895332,//资源id
"resourceStatus": 0,
"trainId": 20463,//车次id
"trainNum": "K463",//车次号
"trainType": 5,//车次类型;0:高铁,1:城际,2:动车,3:直达,4:特快,5:普快,6:其他
"trainTypeName": "普快",//车次类型名称;0:高铁,1:城际,2:动车,3:直达,4:特快,5:普快,6:其他
"departCityId": 1602,//出发城市id
"destCityId": 2500,//到达城市id
"departCityName": "南京",//出发城市名称
"destCityName": "上海",//到达城市名称
"departStationId": 1175374,//出发站id
"destStationId": 1175075,//到达站id
"departStationName": "南京站",//出发站名称
"destStationName": "上海站",//到达站名称
"departArriveTime": null,
"departDepartTime": "08:42",//出发时间
"destArriveTime": "13:47",//到达时间
"destDepartTime": null,
"duration": 305,//历时(分钟)
"durationDay": 1,//历时(天),1表示当天,2表示第二天,以此类推
"departStationType": 2,//过路类型：0:始发；1:终点；2:过路
"destStationType": 1,//过路类型：0:始发；1:终点；2:过路
"seatType": 8,//坐等类型;0:商务座;1:特等座;2:一等座;3:二等座;4:高级软卧;5:软卧;6:硬卧;7:软座;8:硬座;9:无座
"externalOrderId": "",
"apiOrderId": "0",//api订单号
"vendorId": 0,//供应商id
"departsDate": "2026-03-25",//出发日期
"seatTypeName": "硬座",//坐等类型名称
"trainStopFlag": "0",//列车停运标识;0:非停运标识;1:停运标识
"detailInfos": [
{
"resBookId": 39889485,//票id
"touristId": 68472893,//乘客id
"touristName": "张宁",//乘客姓名
"touristType": 0,
"ticketCode": "",
"price": 46.5,//票价
"status": 0,//票状态;0:待购票;1:购票中;2:已购票;3:购票失败;4:退票中;5:已退票;6:已取纸质票;7:线下改签;8:取消中;9:已取消;10:退票失败;11:线下退票;12:改签中;13:改签已取消;14:改签失败;15:已改签;16:改签票;17:改签取消中;18:改签已占位;19:改签取消失败;20:改签确认中;99:其他
"statusName": "",
"resMainId": 532359500,
"ticketUrgeRefundStatus": null
}
]
}
],
"changeTrainTicketList": null,
"insuranceList": [],
"delivery": null,
"refundList": [],
"isDispatchTicket": 0,
"dispatch": null,
"deliveryInformation": null,
"grab": null,
"orderTypeName": [
"13-到站提醒未开启",
"18-线下电子票"
],
"name12306": null,
"occupyType": 0,
"maintainStatus": 0,
"acceptStandingTicket": false,
"canUrgeRefund": 0,
"urgeRefundStatus": null,
"price": 0,
"userId": 46024923,//会员id
"userType": 0,
"source": 3,
"startCityCode": "1602",
"bookCity": "0",
"productId": "47664942",
"sourceType": -1,
"boughtPromotions": null,
"canChanged": 0,
"supportRefund": 0,
"alternateTrainList": null,
"failReasonCode": "",
"insCashBackPrice": 0,
"priceDetail": {
"trainTicketPrice": 0,//车票金额
"insurancePrice": 0,//报销金额
"resVoucherPrice": 0,//红包券金额
"voucherVipPrice": 0,//贵宾厅金额
"grabRateVoucherPrice": 0,//抢票套餐金额
"lossTotalPrice": 0,//核损金额
"couponTravelTotalPrice": 0,//旅游券金额
"trainReducePrice": 0,//火车票立减优惠金额
"orderDiscountAmount": 0,//订单立减金额
"insuranceCashbackPrice": 0,//火车票报销返现金额
"promotionPrdTotalPrice": 0,//促销金额
"bussinessCardPrice": 0,//商旅卡金额
"dispatchDeliverPrice": 0,//配送费
"dispatchPurchasePrice": 0,//配送出票手续费
"refundInsTotalPrice": 0,//退票险金额
"trainOrderFreePrice": 0,//一元免单
"memberRightsPrice": 0,//会员权益价格
"grabUpgradeVoucherPrice": 0,//加油包
"niuPlusGrabVoucherPrice": 0,
"niuPlusTicketDiscountPrice": 0,
"paidAmount": 0,//已付款金额
"refundPrice": 0,//已退款金额
"servicePackagePrice": 0,//服务包价格
"grabCashBackPrice": 0,
"refundApplyAdjustPrice": 0
},
"withHoldType": 0,
"payType": 0,
"servicePackageInfo": {
"packageOrderRelationId": 702379,
"packageType": 29,//服务包类型
"packageName": "15元便捷通道费",//服务包名称
"salePrice": 15,//售卖单价
"number": 1,//订购数量
"status": 0//订购状态;0:未购买;1:已购买;2:已退订
},
"onlinePayFlag": 0,
"payChannels": null,//套皮支付支持的支付渠道;支付宝:33000010;银联:00011000;微信:33000020
"refundServiceFee": 0,//退票服务费
"changeServiceFee": 0,//改签服务费
"trainPersonalTailorVo": null,//定制信息
"changeTicketFee": null,//12306收取的改签费
"rewardInfo": null,//优惠返现信息
"trainAccountAbnormal": 0,
"waitListDescUrl": "https://m.tuniu.com/event/mobileCms/index/actId/zpo5kwg3",
"waitListCanCancel": false,
"showWaitListCreateOrder": false,
"waitListTitle": null,
"waitListSubTitle": null
}
}
触发词：查询订单详情123456
# departureStationName、arrivalStationName、departureDate 从搜索结果或用户需求取，trainNum 从搜索结果取
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"queryTrainOrderDetail","arguments":{"orderId":"<订单号>"}}}'
入参：orderId必填。
入参示例：
{
"orderId": <订单号>
}
返回：successCode（取消成功标识,true:取消成功;false:取消失败）、errorMessage（取消失败原因）。
出参示例：
{
"successCode": true,//true:取消成功;false:取消失败
"errorMessage": null//取消失败返回失败原因
}
触发词：取消订单123456
# departureStationName、arrivalStationName、departureDate 从搜索结果或用户需求取，trainNum 从搜索结果取
curl -s -X POST "${TRAIN_MCP_URL:-https://openapi.tuniu.cn/mcp/train}" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "apiKey: $TUNIU_API_KEY" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"cancelOrder","arguments":{"orderId":"<订单号>"}}}'
{
"jsonrpc": "2.0",
"result": {
"content": [{"type": "text", "text": "..."}]
},
"id": 2
}
result.content[0].text 中。text 为 JSON 字符串，需先 JSON.parse(result.content[0].text) 再使用。successCode、data（车次列表，含 trainNum、departStationName、destStationName、price、seatAvailable 等）。successCode、trainInfo、seatInfo（含 resId、price等）。successCode、orderId、orderDetailUrl。text 解析后为 { "successCode": false, "errorMessage": "错误信息" }，可从 errorMessage 字段取提示文案。本项目中错误分两类，需分别处理：
1. 传输/会话层错误（无 result，仅有顶层 error，通常伴随 HTTP 4xx/5xx）：
{
"jsonrpc": "2.0",
"error": {"code": -32000, "message": "..."},
"id": null
}
2. 工具层错误（HTTP 仍为 200，有 result）：与成功响应结构相同，但 result.content[0].text 解析后为 { "successCode": false, "errorMessage": "错误信息" }。例如参数校验失败、舱位信息失效、下单失败等，从 errorMessage 字段取文案提示用户或重试。
以下示例中，所有参数均从用户表述或上一轮结果中解析并填入，勿用固定值。
用户：查询2026年3月20日南京到上海的火车票
AI 执行：按用户意图填参：departureCityName=南京、arrivalCityName=上海、departureDate=2026-03-20，调用 searchLowestPriceTrain（请求头需带 apiKey、Content-Type、Accept）。解析 result.content[0].text，整理车次列表回复。
用户：还有吗？/ 下一页
AI 执行：用首次查询返回的快照id(queryId) + pageNum=2（或 3、4…）再次调用 searchLowestPriceTrain。
用户：查一下南京南到上海虹桥G203车次详情
AI 执行：从上一轮列表确认出发站南京南，到达站上海虹桥，出发日期2026-03-20，车次号G203，调用 queryTrainDetail；解析坐等后展示价格、余票信息，并提示可预订。
用户：预定二等座，乘客姓名途牛，乘客身份证号 310101199001011234，乘客手机号 13564789999，联系人手机号 13800138000
AI 执行：从最近一次 queryTrainDetail 结果取 resId、price、departsDate；按用户提供的乘客信息填 adultTourists（name=途牛、psptType=1、psptId=310101199001011234、tel=13564789999），contact（tel=13800138000）。成功后回复订单号、订单详情url，并提醒用户完成支付。