File contents 出行票务查询 Skill
整合火车票 (12306) + 机票 (Kiwi.com) 查询，一口令查所有出行方式。
使用方式
在 Claude Code 中
/travel-ticket train query 深圳 上海 2026-07-25
/travel-ticket flight search SZX PVG 2026-07-28
/travel-ticket flight search 广州 墨尔本 2026-11-20 --stops 1 --sort price
/travel-ticket flight search CAN MEL anytime # 任意时间最便宜
/travel-ticket flight roundtrip SZX PVG 2026-07-28 2026-08-01
/travel-ticket flight airport melbourne # 机场/城市搜索
/travel-ticket query 深圳 上海 2026-07-25
/travel-ticket search 广州 墨尔本 2026-11-20
命令行直接调用
# 火车票
python travel.py train query 深圳 上海 2026-07-25
python travel.py train transfer 深圳 上海 2026-07-25 --via 南昌
python travel.py train station 深圳
python travel.py train route G2790 深圳 上海虹桥 2026-07-25
# 机票
python travel.py flight search SZX PVG 2026-07-28
python travel.py flight search 深圳 上海浦东 2026-07-28 --seat business
python travel.py flight search 广州 墨尔本 2026-11-20 --stops 1 --sort price
python travel.py flight search CAN MEL anytime --currency eur
python travel.py flight roundtrip SZX PVG 2026-07-28 2026-08-01
python travel.py flight airport melbourne
python travel.py flight airlines
# 快捷方式
python travel.py query 深圳 上海 2026-07-25 # = train query
python travel.py search CAN MEL 2026-11-20 # = flight search
命令一览
火车票 (train)
命令
参数
说明
train query <from> <to> <date>出发站/到达站/日期
查询余票 + 票价 + 时刻
train price <from> <to> <date>同上
查询各车次票价
train transfer <from> <to> <date>同上
中转换乘方案（余票+票价）
train transfer ... --via <station>指定中转站
指定中转站换乘
train station <keyword>关键词
搜索车站（中/拼/简拼/三字码）
train route <code> <from> <to> <date>车次/站/日
列车经停站时刻表
机票 (flight)
命令
参数
说明
flight search <from> <to> [date]出发机场/到达机场/日期
查询单程航班（价格、时刻、中转、航司）
flight roundtrip <from> <to> <depart> <return>往返日期
查询往返航班（去程+返程完整航班）
flight airport <keyword>关键词
搜索机场/城市（中文名/拼音/IATA）
flight airlines-
列出航空公司代码对照表
flight 选项
选项
值
说明
--seateconomy / premium-economy / business / first舱位（默认 economy）
--passengers数字
乘客数（默认 1）
--stops数字
最大中转数（默认 2，0 = 仅直达）
--sortquality / price / duration / date排序（默认 quality）
--currencycny / usd / eur / gbp / aud / jpy / hkd / sgd币种（默认 cny）
日期与任意时间
flight search 的 date 参数可选：
指定日期（2026-11-20）：查当天航班
省略或 anytime：查未来最便宜的航班（Kiwi 跨数月搜索）
快捷方式
命令
等价于
说明
query <from> <to> <date>train query ...查火车票
search <from> <to> [date]flight search ...查机票
airlinesflight airlines航空公司代码
安装
pip install mcp-server-12306 # 火车票（12306 官方 API）
# 机票模块仅依赖 Python 标准库，无需额外安装
数据来源
火车票
数据来源：12306 官方 API （kyfw.12306.cn/otn/leftTicket/queryI）
库：mcp-server-12306
自动处理 302 重定向 + 浏览器模拟请求头
机票
数据来源：Kiwi.com GraphQL API （api.skypicker.com/umbrella/v2/graphql）
查询：SearchOneWayItinerariesQuery（单程）、SearchReturnItinerariesQuery（往返）、PlacesQuery（机场搜索）
直连，无需鉴权、无需代理，仅用 Python 标准库 urllib
支持中转、自转、隐藏城市等 Kiwi 全部结果类型
价格含币种符号，时长单位为分钟（由秒换算）
机场代码（常用）
中文名
IATA
深圳宝安
SZX
上海浦东
PVG
上海虹桥
SHA
北京首都
PEK
北京大兴
PKX
广州白云
CAN
成都双流/天府
CTU / TFU
杭州萧山
HGH
武汉天河
WUH
重庆江北
CKG
南京禄口
NKG
厦门高崎
XMN
三亚凤凰
SYX
昆明长水
KMG
西安咸阳
XIY
香港国际
HKG
墨尔本
MEL
悉尼
SYD
东京
HND / NRT
新加坡
SIN
曼谷
BKK
吉隆坡
KUL
首尔仁川
ICN
巴黎
CDG
伦敦
LHR
纽约
JFK
洛杉矶
LAX
火车站代码（常用）
车站
三字码
深圳
SZQ
深圳北
IOQ
福田
NZQ
上海
SHH
上海虹桥
AOH
北京
BJP
北京南
VNP
广州南
IZQ
武汉
WHN
南昌
NCG
注意事项
火车票查询日期范围：今天起 14 天内
机票查询无日期限制，Kiwi 支持任意未来日期与跨月「任意时间」搜索
机票价格仅供参考，实际价格以航司和购票平台为准
中转停留标记「换站」表示需在不同机场/车站之间转移，「重取行李」表示需重新办理托运
--stops 0 仅查直达航班；Kiwi 的「自转」(self-transfer) 方案需自行确认签证与重取行李中文城市名搜索命中有限（如「墨尔本」「新加坡」可能 0 命中），建议用拼音或 IATA 三字码
本 skill 仅供学习研究使用
1 --- 2 name: travel-ticket 3 description: Travel Ticket 4 --- 5 6 # 出行票务查询 Skill 7 8 > 整合火车票 (12306) + 机票 (Kiwi.com) 查询，一口令查所有出行方式。 9 10 --- 11 12 ## 使用方式 13 14 ### 在 Claude Code 中 15 16 ``` 17 /travel-ticket train query 深圳 上海 2026-07-25 18 /travel-ticket flight search SZX PVG 2026-07-28 19 /travel-ticket flight search 广州 墨尔本 2026-11-20 --stops 1 --sort price 20 /travel-ticket flight search CAN MEL anytime # 任意时间最便宜 21 /travel-ticket flight roundtrip SZX PVG 2026-07-28 2026-08-01 22 /travel-ticket flight airport melbourne # 机场/城市搜索 23 /travel-ticket query 深圳 上海 2026-07-25 24 /travel-ticket search 广州 墨尔本 2026-11-20 25 ``` 26 27 ### 命令行直接调用 28 29 ```bash 30 # 火车票 31 python travel.py train query 深圳 上海 2026-07-25 32 python travel.py train transfer 深圳 上海 2026-07-25 --via 南昌 33 python travel.py train station 深圳 34 python travel.py train route G2790 深圳 上海虹桥 2026-07-25 35 36 # 机票 37 python travel.py flight search SZX PVG 2026-07-28 38 python travel.py flight search 深圳 上海浦东 2026-07-28 --seat business 39 python travel.py flight search 广州 墨尔本 2026-11-20 --stops 1 --sort price 40 python travel.py flight search CAN MEL anytime --currency eur 41 python travel.py flight roundtrip SZX PVG 2026-07-28 2026-08-01 42 python travel.py flight airport melbourne 43 python travel.py flight airlines 44 45 # 快捷方式 46 python travel.py query 深圳 上海 2026-07-25 # = train query 47 python travel.py search CAN MEL 2026-11-20 # = flight search 48 ``` 49 50 --- 51 52 ## 命令一览 53 54 ### 火车票 (train) 55 56 | 命令 | 参数 | 说明 | 57 |------|------|------| 58 | `train query <from> <to> <date>` | 出发站/到达站/日期 | 查询余票 + 票价 + 时刻 | 59 | `train price <from> <to> <date>` | 同上 | 查询各车次票价 | 60 | `train transfer <from> <to> <date>` | 同上 | 中转换乘方案（余票+票价） | 61 | `train transfer ... --via <station>` | 指定中转站 | 指定中转站换乘 | 62 | `train station <keyword>` | 关键词 | 搜索车站（中/拼/简拼/三字码） | 63 | `train route <code> <from> <to> <date>` | 车次/站/日 | 列车经停站时刻表 | 64 65 ### 机票 (flight) 66 67 | 命令 | 参数 | 说明 | 68 |------|------|------| 69 | `flight search <from> <to> [date]` | 出发机场/到达机场/日期 | 查询单程航班（价格、时刻、中转、航司） | 70 | `flight roundtrip <from> <to> <depart> <return>` | 往返日期 | 查询往返航班（去程+返程完整航班） | 71 | `flight airport <keyword>` | 关键词 | 搜索机场/城市（中文名/拼音/IATA） | 72 | `flight airlines` | - | 列出航空公司代码对照表 | 73 74 ### flight 选项 75 76 | 选项 | 值 | 说明 | 77 |------|-----|------| 78 | `--seat` | `economy` / `premium-economy` / `business` / `first` | 舱位（默认 economy） | 79 | `--passengers` | 数字 | 乘客数（默认 1） | 80 | `--stops` | 数字 | 最大中转数（默认 2，0 = 仅直达） | 81 | `--sort` | `quality` / `price` / `duration` / `date` | 排序（默认 quality） | 82 | `--currency` | `cny` / `usd` / `eur` / `gbp` / `aud` / `jpy` / `hkd` / `sgd` | 币种（默认 cny） | 83 84 ### 日期与任意时间 85 86 `flight search` 的 `date` 参数可选： 87 - 指定日期（`2026-11-20`）：查当天航班 88 - 省略或 `anytime`：查未来最便宜的航班（Kiwi 跨数月搜索） 89 90 ### 快捷方式 91 92 | 命令 | 等价于 | 说明 | 93 |------|--------|------| 94 | `query <from> <to> <date>` | `train query ...` | 查火车票 | 95 | `search <from> <to> [date]` | `flight search ...` | 查机票 | 96 | `airlines` | `flight airlines` | 航空公司代码 | 97 98 --- 99 100 ## 安装 101 102 ```bash 103 pip install mcp-server-12306 # 火车票（12306 官方 API） 104 # 机票模块仅依赖 Python 标准库，无需额外安装 105 ``` 106 107 --- 108 109 ## 数据来源 110 111 ### 火车票 112 - 数据来源：**12306 官方 API**（`kyfw.12306.cn/otn/leftTicket/queryI`） 113 - 库：`mcp-server-12306` 114 - 自动处理 302 重定向 + 浏览器模拟请求头 115 116 ### 机票 117 - 数据来源：**Kiwi.com GraphQL API**（`api.skypicker.com/umbrella/v2/graphql`） 118 - 查询：`SearchOneWayItinerariesQuery`（单程）、`SearchReturnItinerariesQuery`（往返）、`PlacesQuery`（机场搜索） 119 - 直连，无需鉴权、无需代理，仅用 Python 标准库 `urllib` 120 - 支持中转、自转、隐藏城市等 Kiwi 全部结果类型 121 - 价格含币种符号，时长单位为分钟（由秒换算） 122 123 --- 124 125 ## 机场代码（常用） 126 127 | 中文名 | IATA | 128 |--------|------| 129 | 深圳宝安 | SZX | 130 | 上海浦东 | PVG | 131 | 上海虹桥 | SHA | 132 | 北京首都 | PEK | 133 | 北京大兴 | PKX | 134 | 广州白云 | CAN | 135 | 成都双流/天府 | CTU / TFU | 136 | 杭州萧山 | HGH | 137 | 武汉天河 | WUH | 138 | 重庆江北 | CKG | 139 | 南京禄口 | NKG | 140 | 厦门高崎 | XMN | 141 | 三亚凤凰 | SYX | 142 | 昆明长水 | KMG | 143 | 西安咸阳 | XIY | 144 | 香港国际 | HKG | 145 | 墨尔本 | MEL | 146 | 悉尼 | SYD | 147 | 东京 | HND / NRT | 148 | 新加坡 | SIN | 149 | 曼谷 | BKK | 150 | 吉隆坡 | KUL | 151 | 首尔仁川 | ICN | 152 | 巴黎 | CDG | 153 | 伦敦 | LHR | 154 | 纽约 | JFK | 155 | 洛杉矶 | LAX | 156 157 ## 火车站代码（常用） 158 159 | 车站 | 三字码 | 160 |------|--------| 161 | 深圳 | SZQ | 162 | 深圳北 | IOQ | 163 | 福田 | NZQ | 164 | 上海 | SHH | 165 | 上海虹桥 | AOH | 166 | 北京 | BJP | 167 | 北京南 | VNP | 168 | 广州南 | IZQ | 169 | 武汉 | WHN | 170 | 南昌 | NCG | 171 172 --- 173 174 ## 注意事项 175 176 1. 火车票查询日期范围：今天起 14 天内 177 2. 机票查询无日期限制，Kiwi 支持任意未来日期与跨月「任意时间」搜索 178 3. 机票价格仅供参考，实际价格以航司和购票平台为准 179 4. 中转停留标记「换站」表示需在不同机场/车站之间转移，「重取行李」表示需重新办理托运 180 5. `--stops 0` 仅查直达航班；Kiwi 的「自转」(self-transfer) 方案需自行确认签证与重取行李 181 6. 中文城市名搜索命中有限（如「墨尔本」「新加坡」可能 0 命中），建议用拼音或 IATA 三字码 182 7. 本 skill 仅供学习研究使用
commit 1454f8f73b
Frequently asked questions How do I install the Travel Ticket skill? Run npx skillmds@latest add id-verne/travel-ticket in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Travel Ticket skill do? Travel Ticket It is listed under Coding & Dev Tools on SkillMD.
Is Travel Ticket safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Travel Ticket? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Travel Ticket free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Travel Ticket? id-verne (@id-verne) published this skill. Their other Agent Skills are listed on their SkillMD profile.
id-verne