Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Added documentation file: README.md - Removed cached station data file: data/stations.json - Updated documentation to include new output format option (`-f, --format <html|md>`) for markdown table output - Clarified usage examples and output modes in the documentation
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
Here's how your AI assistant might use this skill in practice.
User asks: What G-trains run from Shanghai to Hangzhou tomorrow morning with second-class seats available?
- 1Identify origin (上海), destination (杭州), date, and constraints from the request
- 2Run query with -t G --depart 06:00-12:00 --seat ze --available and tomorrow's date
- 3Parse the markdown table output returned to stdout
- 4Present 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