12306 Train Query
Query train schedules and remaining tickets from China Railway 12306.
Query Tickets
node {baseDir}/scripts/query.mjs <from> <to> [options]
- HTML mode (default): writes file, prints path to stdout
- Markdown mode (
-f md): prints table to stdout
Examples
# All trains from Beijing to Shanghai (defaults to today)
node {baseDir}/scripts/query.mjs 北京 上海
# Markdown table output (to stdout, good for chat)
node {baseDir}/scripts/query.mjs 北京 上海 -t G -f md
# Morning departures, 2h max, with second class available
node {baseDir}/scripts/query.mjs 上海 杭州 -t G --depart 06:00-12:00 --max-duration 1h --seat ze
# Only bookable trains arriving before 6pm
node {baseDir}/scripts/query.mjs 深圳 长沙 --available --arrive -18:00
# Custom output path
node {baseDir}/scripts/query.mjs 广州 武汉 -o /tmp/tickets.html
# JSON output (to stdout)
node {baseDir}/scripts/query.mjs 广州 武汉 --json
Options
-d, --date <YYYY-MM-DD>: Travel date (default: today)-t, --type <G|D|Z|T|K>: Filter train types (combinable, e.g. GD)--depart <HH:MM-HH:MM>: Depart time range (e.g. 08:00-12:00, 18:00-)--arrive <HH:MM-HH:MM>: Arrive time range (e.g. -18:00, 14:00-20:00)--max-duration <duration>: Max travel time (e.g. 2h, 90m, 1h30m)--available: Only show bookable trains--seat <types>: Only show trains with tickets for given seat types (comma-separated: swz,zy,ze,rw,dw,yw,yz,wz)-f, --format <html|md>: Output format — html (default, saves file) or md (markdown table to stdout)-o, --output <path>: Output file path, html mode only (default: {baseDir}/data/<from>-<to>-<date>.html)--json: Output raw JSON to stdout
Output Columns
| Column |
Meaning |
| 商务/特等 |
Business class / Premium (swz) |
| 一等座 |
First class (zy) |
| 二等座 |
Second class (ze) |
| 软卧/动卧 |
Soft sleeper / Bullet sleeper (rw/dw) |
| 硬卧 |
Hard sleeper (yw) |
| 硬座 |
Hard seat (yz) |
| 无座 |
Standing (wz) |
Values: number = remaining seats, 有 = available (qty unknown), — = not applicable
Station Lookup
node {baseDir}/scripts/stations.mjs 杭州
node {baseDir}/scripts/stations.mjs 香港西九龙
Notes
- Data comes directly from 12306 official API (no key needed)
- Station data is cached for 7 days in
{baseDir}/data/stations.json
- Supports city names (resolves to main station) or exact station names
- Works for all train types: G (高铁), D (动车), Z (直达), T (特快), K (快速)
1---2name: 123063description: Query China Railway 12306 for train schedules, remaining tickets, and station info. Use when user asks about train/高铁/火车 tickets, schedules, or availability within China.4---56# 12306 Train Query78Query train schedules and remaining tickets from China Railway 12306.910## Query Tickets1112```bash13node {baseDir}/scripts/query.mjs <from> <to> [options]14```1516- HTML mode (default): writes file, prints path to stdout17- Markdown mode (`-f md`): prints table to stdout1819### Examples2021```bash22# All trains from Beijing to Shanghai (defaults to today)23node {baseDir}/scripts/query.mjs 北京 上海2425# Markdown table output (to stdout, good for chat)26node {baseDir}/scripts/query.mjs 北京 上海 -t G -f md2728# Morning departures, 2h max, with second class available29node {baseDir}/scripts/query.mjs 上海 杭州 -t G --depart 06:00-12:00 --max-duration 1h --seat ze3031# Only bookable trains arriving before 6pm32node {baseDir}/scripts/query.mjs 深圳 长沙 --available --arrive -18:003334# Custom output path35node {baseDir}/scripts/query.mjs 广州 武汉 -o /tmp/tickets.html3637# JSON output (to stdout)38node {baseDir}/scripts/query.mjs 广州 武汉 --json39```4041### Options4243- `-d, --date <YYYY-MM-DD>`: Travel date (default: today)44- `-t, --type <G|D|Z|T|K>`: Filter train types (combinable, e.g. `GD`)45- `--depart <HH:MM-HH:MM>`: Depart time range (e.g. `08:00-12:00`, `18:00-`)46- `--arrive <HH:MM-HH:MM>`: Arrive time range (e.g. `-18:00`, `14:00-20:00`)47- `--max-duration <duration>`: Max travel time (e.g. `2h`, `90m`, `1h30m`)48- `--available`: Only show bookable trains49- `--seat <types>`: Only show trains with tickets for given seat types (comma-separated: `swz,zy,ze,rw,dw,yw,yz,wz`)50- `-f, --format <html|md>`: Output format — `html` (default, saves file) or `md` (markdown table to stdout)51- `-o, --output <path>`: Output file path, html mode only (default: `{baseDir}/data/<from>-<to>-<date>.html`)52- `--json`: Output raw JSON to stdout5354### Output Columns5556| Column | Meaning |57|--------|---------|58| 商务/特等 | Business class / Premium (swz) |59| 一等座 | First class (zy) |60| 二等座 | Second class (ze) |61| 软卧/动卧 | Soft sleeper / Bullet sleeper (rw/dw) |62| 硬卧 | Hard sleeper (yw) |63| 硬座 | Hard seat (yz) |64| 无座 | Standing (wz) |6566Values: number = remaining seats, `有` = available (qty unknown), `—` = not applicable6768## Station Lookup6970```bash71node {baseDir}/scripts/stations.mjs 杭州72node {baseDir}/scripts/stations.mjs 香港西九龙73```7475## Notes7677- Data comes directly from 12306 official API (no key needed)78- Station data is cached for 7 days in `{baseDir}/data/stations.json`79- Supports city names (resolves to main station) or exact station names80- Works for all train types: G (高铁), D (动车), Z (直达), T (特快), K (快速)
dvcrn