An AI-ready tool for retrieving real-time train schedules and seat availability directly from China's 12306 railway system.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 12306-train-query
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install 12306-train-query using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is 12306 Train Query Skill?
The 12306 Train Query skill is a specialized utility designed for AI agents to access real-time railway data in China. By leveraging this tool within the Openclaw Skills framework, developers can enable their agents to provide accurate information on train availability, pricing categories, and scheduling. This bridges the gap between AI conversation and actionable transit data, making it indispensable for travel-oriented automation.
This skill supports a wide range of train types, from high-speed rail to traditional overnight expresses. It simplifies the complexity of interacting with railway APIs, offering a clean CLI interface that returns structured seat data, including Business, First Class, and Second Class availability. Integrating this into your Openclaw Skills setup ensures your AI agent remains a highly capable travel assistant.
12306 Train Query Skill Use Cases
- Checking real-time seat availability for high-speed rail between major urban hubs.
- Automating travel itinerary planning by retrieving train durations and arrival times.
- Monitoring ticket status for specific dates to assist with booking decisions.
- Providing developers with a programmatic way to include train data in Openclaw Skills workflows.
How 12306 Train Query Skill Works
- The user or agent provides the departure station, destination, and travel date.
- The skill invokes a Node.js script that communicates with the 12306 data service.
- The system maps city names to station codes required for the query.
- It fetches and parses the train schedule, including train numbers and class-specific seat counts.
- The formatted data is returned as a structured output for the AI agent to interpret within the Openclaw Skills environment.
12306 Train Query Skill Setup
To use this skill, ensure your environment has Node.js installed. Follow these steps to get started with this part of your Openclaw Skills collection:
- Download the train_query.js script to your local scripts directory.
- Execute the query using the following CLI format:
node scripts/train_query.js [Departure] [Arrival] [YYYY-MM-DD]
- For example, to check tickets from Changsha to Beijing for March 16, 2026, run:
node scripts/train_query.js Changsha Beijing 2026-03-16
12306 Train Query Skill Data Schema & Taxonomy
The output provides a comprehensive overview of the train journey status. Key data points include:
| Attribute | Description |
|---|---|
| Train Type | Categorized as G (High-speed), D (Bullet), Z (Direct), T (Express), or K (Fast). |
| Station Info | Names of the departure and arrival stations. |
| Schedule | Departure time, arrival time, and total travel duration. |
| Seat Inventory | Remaining tickets for Business, First Class, Second Class, Soft Sleeper, and Hard Sleeper. |
This structured data is ideal for parsing by AI agents using Openclaw Skills.
12306 Train Query Skill Advanced Features
- Multi-category train support covering the entire range of the 12306 network.
- Seamless integration with other Openclaw Skills for end-to-end travel planning.
- High-speed data retrieval optimized for low-latency AI agent responses.
- Robust error handling for invalid station names or past travel dates.
SKILL.md
Loading
Related Openclaw Skills
Backlink Strategy
A comprehensive framework for ecommerce stores to build domain authority through high-value outreach, partnership identification, and the creation of linkable content assets.
Designer: Aesthetic System Framework
A sophisticated design system that unifies major art and design movements into a functional framework for creating visual identities and AI prompts.
Autobiographical Memory
A structured personal memory system that allows AI agents to persist, consolidate, and recall episodic and semantic memories across multiple sessions.
Course Syllabus Decoder
An intelligent academic workflow that converts raw course syllabus data into structured semester plans and study systems.
CC Ride-Hailing Passenger Prototype
A specialized design system skill for extending the CC Ride-Hailing passenger-side HTML/CSS prototypes with strict architectural consistency.
TradeAlpha News V2
TradeAlpha News V2 provides AI agents with real-time global financial news and high-precision semantic search capabilities for market analysis.
Featured*
