← 返回 Skills 市场
12306 Query
作者
zhangsaizz
· GitHub ↗
· v1.0.0
· MIT-0
159
总下载
0
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install 12306-query
功能描述
Query China Railway 12306 for train schedules, remaining tickets, and station info. Use when user asks about train/高铁/火车 tickets, schedules, or availability...
使用说明 (SKILL.md)
12306 Train Query
Query train schedules and remaining tickets from China Railway 12306.
Query Tickets
node {baseDir}/scripts/query.mjs \x3Cfrom> \x3Cto> [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 \x3CYYYY-MM-DD>: Travel date (default: today)-t, --type \x3CG|D|Z|T|K>: Filter train types (combinable, e.g.GD)--depart \x3CHH:MM-HH:MM>: Depart time range (e.g.08:00-12:00,18:00-)--arrive \x3CHH:MM-HH:MM>: Arrive time range (e.g.-18:00,14:00-20:00)--max-duration \x3Cduration>: Max travel time (e.g.2h,90m,1h30m)--available: Only show bookable trains--seat \x3Ctypes>: Only show trains with tickets for given seat types (comma-separated:swz,zy,ze,rw,dw,yw,yz,wz)-f, --format \x3Chtml|md>: Output format —html(default, saves file) ormd(markdown table to stdout)-o, --output \x3Cpath>: Output file path, html mode only (default:{baseDir}/data/\x3Cfrom>-\x3Cto>-\x3Cdate>.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 (快速)
安全使用建议
This skill appears to do exactly what it says: it requires Node.js and will make HTTPS requests to kyfw.12306.cn / www.12306.cn at runtime, then cache station data in data/stations.json and optionally write HTML output files in the skill directory or a user-specified path. No credentials are requested. Before installing, ensure you trust the skill source (there are small metadata inconsistencies between the registry Owner ID, _meta.json, and README install path), confirm you have Node >= 18 so the built-in fetch is available, and be comfortable with the skill writing a cache file under its data/ directory. If you need stronger assurance, ask the publisher for provenance (author account) or run the scripts in an isolated environment first.
功能分析
Type: OpenClaw Skill
Name: 12306-query
Version: 1.0.0
The skill bundle is a legitimate tool for querying the China Railway 12306 API for train schedules and ticket availability. The scripts (query.mjs and stations.mjs) communicate exclusively with official 12306 domains (12306.cn and kyfw.12306.cn) and use local file storage for caching station data and saving generated HTML reports. There is no evidence of data exfiltration, malicious execution, or prompt injection; the code is well-documented and its behaviors are strictly aligned with the stated purpose.
能力评估
Purpose & Capability
Name/description ask for 12306 queries and the package requires only Node and includes two scripts that call 12306 endpoints and a station cache. Required binaries (node) and bundled station data are appropriate. Minor bookkeeping inconsistency: _meta.json ownerId and the registry Owner ID/README install path differ (suggests a forked/copy origin) but this does not affect functionality.
Instruction Scope
SKILL.md instructs running the included node scripts; the scripts perform only the advertised actions: fetching station_name.js and leftTicket/query from 12306, parsing results, printing JSON/MD or writing an HTML file, and caching stations.json. The scripts write/read a local cache (data/stations.json) and output HTML/JSON as described; they do not read other system files or access unrelated environment variables or external endpoints.
Install Mechanism
No install spec — instruction-only plus included source files. Nothing is downloaded at install time; network access occurs at runtime (fetching 12306). This is low-risk and proportionate to the skill.
Credentials
The skill requests no environment variables or credentials. It only uses network access to 12306 and local filesystem access to cache station data and save HTML output — both expected for the stated purpose.
Persistence & Privilege
always:false and no requests to persist or modify other skills or agent-wide configuration. The only persistence is a local cache file under the skill's data directory (data/stations.json), which is appropriate for performance.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install 12306-query - 安装完成后，直接呼叫该 Skill 的名称或使用
/12306-query触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of 12306-query: a tool to query China Railway 12306 for train schedules, remaining ticket availability, and station information.
- Supports flexible search by city or station name, date, train type, departure/arrival time, and seat class.
- Multiple output formats: HTML (file), Markdown (table to stdout), and JSON.
- Includes advanced filters such as duration, available/bookable trains, and specific seat types.
- Built-in station lookup with 7-day local caching.
- Fetches live data directly from the official 12306 API; no API key required.
元数据
常见问题
12306 Query 是什么？
Query China Railway 12306 for train schedules, remaining tickets, and station info. Use when user asks about train/高铁/火车 tickets, schedules, or availability... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 159 次。
如何安装 12306 Query？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install 12306-query」即可一键安装，无需额外配置。
12306 Query 是免费的吗？
是的，12306 Query 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
12306 Query 支持哪些平台？
12306 Query 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 12306 Query？
由 zhangsaizz（@zhangsaizz）开发并维护，当前版本 v1.0.0。
推荐 Skills