✓ Verified 💻 Development ✓ Enhanced Data

12306

Query China Railway 12306 for train schedules, remaining tickets, and station info.

Rating: 4.3 (338 reviews)
Downloads: 939 downloads
Version: 1.0.0

Overview

Query China Railway 12306 for train schedules, remaining tickets, and station info.

Complete Documentation

View Source →

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 : Travel date (default: today)
-t, --type : Filter train types (combinable, e.g. GD)
--depart : Depart time range (e.g. 08:00-12:00, 18:00-)
--arrive : Arrive time range (e.g. -18:00, 14:00-20:00)
--max-duration : Max travel time (e.g. 2h, 90m, 1h30m)
--available: Only show bookable trains
--seat : Only show trains with tickets for given seat types (comma-separated: swz,zy,ze,rw,dw,yw,yz,wz)
-f, --format : Output format — html (default, saves file) or md (markdown table to stdout)
-o, --output : Output file path, html mode only (default: {baseDir}/data/--.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

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

Installation

Terminal bash


openclaw install 12306

Copied!

💻Code Examples

node {baseDir}/scripts/query.mjs <from> <to> [options]

node-basedirscriptsquerymjs-from-to-options.txt

- HTML mode (default): writes file, prints path to stdout
- Markdown mode (`-f md`): prints table to stdout

### Examples

node {baseDir}/scripts/query.mjs 广州武汉 --json

node-basedirscriptsquerymjs-----json.txt

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

example.sh

# 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