12306 Train Query#

Query train schedules and remaining tickets from China Railway 12306.

Query Tickets#

bash

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#

bash

# 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#

ColumnMeaning商务/特等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#

bash

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 (快速)