← 返回 Skills 市场
danihe001

12306 Backup

作者 steve xia · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
101
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 12306-backup
功能描述
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) or md (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 (快速)
安全使用建议
Functionally and security-wise the skill is coherent with its purpose: it fetches data from official 12306 endpoints and caches station data locally, and it does not request secrets. Before installing, however, verify the skill's provenance (source/homepage is unknown here) and run it in a trusted/isolated environment if you don't trust the author. Also ensure you have Node.js >=18 (the code uses global fetch) and be aware the scripts will create/overwrite files under the skill's data directory and any output paths you provide. If you need higher assurance, review the included scripts locally (they are short and readable) or run them with network monitoring to confirm they only contact 12306 domains.
功能分析
Type: OpenClaw Skill Name: 12306-backup Version: 1.0.0 The skill bundle is a legitimate tool for querying China Railway 12306 train schedules and ticket availability. The code in `scripts/query.mjs` and `scripts/stations.mjs` interacts exclusively with official 12306 domains (kyfw.12306.cn and www.12306.cn) to fetch and cache station data and ticket information. It uses standard Node.js built-in modules, contains no obfuscation, and lacks any indicators of data exfiltration, unauthorized execution, or malicious prompt injection.
能力评估
Purpose & Capability
Name/description, SKILL.md, and the two JS scripts all focus on querying 12306, parsing results, and producing HTML/MD/JSON output. The only required binary is node, which is appropriate for the provided Node.js scripts.
Instruction Scope
Runtime instructions only run the included scripts. The scripts fetch data from 12306 domains, parse and filter results, and write cache/output files under the skill's data path — all within the described scope. No unrelated files, system credentials, or external endpoints are accessed.
Install Mechanism
This is an instruction-only skill with included scripts and no install spec. No downloads from third-party URLs or archive extraction are performed by the skill itself.
Credentials
The skill requires no environment variables or credentials. It only needs Node.js runtime; no unexpected secret access is requested.
Persistence & Privilege
always is false and the skill does not request permanent platform privileges. It caches station data and writes output files under its own data path only, which is expected behavior.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install 12306-backup
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /12306-backup 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of 12306-backup skill. - Query China Railway 12306 for train schedules, remaining tickets, and station information. - Supports detailed filtering (train type, departures, arrivals, duration, seat type, availability). - Multiple output formats: HTML, Markdown (table), and JSON. - Includes station lookup by city or station name. - Data sourced directly from the official 12306 API; no key required.
元数据
Slug 12306-backup
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

12306 Backup 是什么?

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 插件,目前累计下载 101 次。

如何安装 12306 Backup?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install 12306-backup」即可一键安装,无需额外配置。

12306 Backup 是免费的吗?

是的,12306 Backup 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

12306 Backup 支持哪些平台?

12306 Backup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 12306 Backup?

由 steve xia(@danihe001)开发并维护,当前版本 v1.0.0。

💬 留言讨论