12306
by kirorab
DevOps & CloudBrief
Query China Railway 12306 for train schedules, remaining tickets, and station info.
Description
What This Skill Does
Queries China Railway 12306 for train schedules, remaining ticket counts, and station information. Supports filtering by train type, departure/arrival time windows, travel duration, and seat class. Data comes directly from the official 12306 API with no authentication required.
Queries the official 12306 API directly, so results reflect real-time seat availability without requiring an account or third-party service.
When to Use It
- Checking G-train availability between Beijing and Shanghai for tomorrow
- Finding morning high-speed trains with second-class seats available
- Looking up the correct station code for a city before booking
- Filtering trains that arrive before a specific time for a business trip
- Comparing travel options across multiple train types on a given date
Example Workflow
User asks: What G-trains run from Shanghai to Hangzhou tomorrow morning with second-class seats available?
- 1
Identify origin (上海), destination (杭州), date, and constraints from the request
- 2
Run query with -t G --depart 06:00-12:00 --seat ze --available and tomorrow's date
- 3
Parse the markdown table output returned to stdout
- 4
Present the matching train numbers, departure times, arrival times, and remaining seat counts
A filtered list of G-trains with morning departures, travel duration, and available second-class seat counts
Installation
clawhub install kirorab/12306Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.