# Travel Ticket

> Travel Ticket

- Skill: `id-verne/travel-ticket` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add id-verne/travel-ticket`
- Raw SKILL.md: https://api.skillmd.com/api/skills/id-verne/travel-ticket/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: id-verne (https://skillmd.com/u/id-verne)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/id-verne/travel-ticket

---


# 出行票务查询 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
```

### 命令行直接调用

```bash
# 火车票
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 选项

| 选项 | 值 | 说明 |
|------|-----|------|
| `--seat` | `economy` / `premium-economy` / `business` / `first` | 舱位（默认 economy） |
| `--passengers` | 数字 | 乘客数（默认 1） |
| `--stops` | 数字 | 最大中转数（默认 2，0 = 仅直达） |
| `--sort` | `quality` / `price` / `duration` / `date` | 排序（默认 quality） |
| `--currency` | `cny` / `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 ...` | 查机票 |
| `airlines` | `flight airlines` | 航空公司代码 |

---

## 安装

```bash
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 |

---

## 注意事项

1. 火车票查询日期范围：今天起 14 天内
2. 机票查询无日期限制，Kiwi 支持任意未来日期与跨月「任意时间」搜索
3. 机票价格仅供参考，实际价格以航司和购票平台为准
4. 中转停留标记「换站」表示需在不同机场/车站之间转移，「重取行李」表示需重新办理托运
5. `--stops 0` 仅查直达航班；Kiwi 的「自转」(self-transfer) 方案需自行确认签证与重取行李
6. 中文城市名搜索命中有限（如「墨尔本」「新加坡」可能 0 命中），建议用拼音或 IATA 三字码
7. 本 skill 仅供学习研究使用