12306 Train Query

Query China Railway 12306 for train schedules, remaining tickets, and station info. Use when user asks about train/高铁/火车 tickets, schedules, or availability...

Popular

Join 2,569+ developers using this skill

skill

Search & Research

beginner

2,569 installs

View Source

Last updated: April 29, 2026

AI Skill Market Insights

Real data. Real impact.

Popularity

Top 50%

Growing

Active Users

2,569+

Developers

Quick Start

Manual Installation

No automatic installation available. Please visit the source repository for installation instructions.

View Installation Instructions

TEAR & SHARE

3-5hrs/WK

RISING

2.6K+ USING

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

12306 Train Query

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

Anysearch MCP Server

Be Part of the 2,569+ Developer Community

12306 Train Query

Query Tickets

Examples

Markdown table output (to stdout, good for chat)

Morning departures, 2h max, with second class available

Only bookable trains arriving before 6pm

Custom output path

JSON output (to stdout)

Options

Output Columns

Station Lookup

Notes

Bullshit Detector

arXiv MCP Server

Research Analyst

DuckDuckGo MCP Server

Channels

Learn

Compare

Company

Agents