How do I install the 12306 skill?

Run npx skillmds@latest add modbender/12306 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is 12306 safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with 12306?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is 12306 free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

12306 by modbender — Agent Skill

Name: 12306
Rating: 4.5 (4 reviews)
Author: modbender

File contents

12306 Train Query

Query train schedules and remaining tickets from China Railway 12306. Output is an HTML file.

Query Tickets

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

The command prints the output file path to stdout and query info to stderr.

Examples

# All trains from Beijing to Shanghai (defaults to today)
node {baseDir}/scripts/query.mjs 北京 上海

# Specify a date
node {baseDir}/scripts/query.mjs 北京 上海 -d 2026-03-01

# Only high-speed trains (G)
node {baseDir}/scripts/query.mjs 北京 上海 -t G

# 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)
-o, --output <path>: Output HTML file path (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 (快速)

---name: 12306description: Query China Railway 12306 for train schedules, remaining tickets, and station info. Use when user asks about train/高铁/火车 tickets, schedules, or availability within China.--- # 12306 Train Query Query train schedules and remaining tickets from China Railway 12306. Output is an HTML file. ## Query Tickets ```bash node {baseDir}/scripts/query.mjs <from> <to> [options] ``` The command prints the output file path to stdout and query info to stderr. ### Examples ```bash # All trains from Beijing to Shanghai (defaults to today) node {baseDir}/scripts/query.mjs 北京上海 # Specify a date node {baseDir}/scripts/query.mjs 北京上海 -d 2026-03-01 # Only high-speed trains (G) node {baseDir}/scripts/query.mjs 北京上海 -t G # 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`) - `-o, --output <path>`: Output HTML file path (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 ```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 (快速)

Frequently asked questions

12306