12306列车时刻表查询工具 - 命令行查询余票、车站信息与中转指南

12306 by kirorab/12306-skill

303 周安装量

3 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/kirorab/12306-skill --skill 12306

命令行工具数据处理 API

🇨🇳中文介绍

12306 列车查询

查询中国铁路 12306 的列车时刻表和余票信息。

查询车票

node {baseDir}/scripts/query.mjs <from> <to> [options]

HTML 模式（默认）：写入文件，将文件路径打印到标准输出
Markdown 模式（-f md）：将表格打印到标准输出

示例

# 从北京到上海的所有列车（默认为今天）
node {baseDir}/scripts/query.mjs 北京 上海

# Markdown 表格输出（到标准输出，适合聊天）
node {baseDir}/scripts/query.mjs 北京 上海 -t G -f md

# 早上发车，最多 2 小时，且二等座有票
node {baseDir}/scripts/query.mjs 上海 杭州 -t G --depart 06:00-12:00 --max-duration 1h --seat ze

# 仅显示下午 6 点前到达且可预订的列车
node {baseDir}/scripts/query.mjs 深圳 长沙 --available --arrive -18:00

# 自定义输出路径
node {baseDir}/scripts/query.mjs 广州 武汉 -o /tmp/tickets.html

# JSON 输出（到标准输出）
node {baseDir}/scripts/query.mjs 广州 武汉 --json

选项

-d, --date <YYYY-MM-DD>：出行日期（默认：今天）
-t, --type <G|D|Z|T|K>：筛选列车类型（可组合，例如）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Lark CLI Wiki API 使用指南：获取知识空间节点信息与权限管理

30,300 周安装

lark-cli 共享规则：飞书资源操作指南与权限配置详解

30,200 周安装

Lark CLI妙记查询工具：快速获取飞书妙记元信息（标题、封面、时长）

30,100 周安装

--depart <HH:MM-HH:MM>：发车时间范围（例如 08:00-12:00, 18:00-）

--arrive <HH:MM-HH:MM>：到达时间范围（例如 -18:00, 14:00-20:00）

--max-duration <duration>：最长旅行时间（例如 2h, 90m, 1h30m）

--available：仅显示可预订的列车

--seat <types>：仅显示指定席别有票的列车（逗号分隔：swz,zy,ze,rw,dw,yw,yz,wz）

-f, --format <html|md>：输出格式 — html（默认，保存文件）或 md（markdown 表格到标准输出）

-o, --output <path>：输出文件路径，仅限 html 模式（默认：{baseDir}/data/<from>-<to>-<date>.html）

--json：将原始 JSON 输出到标准输出

列	含义
商务/特等	商务座 / 特等座 (swz)
一等座	一等座 (zy)
二等座	二等座 (ze)
软卧/动卧	软卧 / 动卧 (rw/dw)
硬卧	硬卧 (yw)
硬座	硬座 (yz)
无座	无座 (wz)

值说明：数字 = 剩余座位数，有 = 有票（数量未知），— = 不适用

node {baseDir}/scripts/stations.mjs 杭州
node {baseDir}/scripts/stations.mjs 香港西九龙

给 AI 助手的重要说明

⚠️ 车站名称解析警告

重要提示：当按城市名称（例如"武汉"、"上海"、"深圳"、"广州"）查询时，API 可能返回该城市内任意车站出发/到达的列车，而不仅仅是主车站。

武汉包括：武汉站（主站）、汉口站、武昌站、武汉东站
上海包括：上海虹桥站、上海站（主站）、上海南站、上海松江站
深圳包括：深圳北站（主站）、深圳站（罗湖）、福田站、深圳东站
广州包括：广州南站（主站）、广州站、广州东站、广州北站

最佳实践 - 始终验证确切的车站：

首先，使用 stations.mjs 列出城市中的所有车站：

node {baseDir}/scripts/stations.mjs 武汉
然后，使用确切的车站名称进行查询以获得准确结果：

node {baseDir}/scripts/query.mjs 武汉上海虹桥 -f md

🔄 中转/换乘指南

使用 JSON 输出（--json）来验证确切的车站名称
确保两个行程段使用相同的车站（例如，都使用武汉站，而不是武汉→汉口）
建议在同一车站的最小换乘时间：20-30 分钟
同一城市内的不同车站需要额外的交通时间（例如，武汉→汉口乘坐地铁需要 30+ 分钟）

📋 查询工作流程建议

为了获得准确结果，请遵循此工作流程：

列出出发城市的所有车站：

node {baseDir}/scripts/stations.mjs 北京
列出到达城市的所有车站：

node {baseDir}/scripts/stations.mjs 上海
使用确切的车站名称进行查询（例如，北京南 → 上海虹桥）：

node {baseDir}/scripts/query.mjs 北京南上海虹桥 -d 2026-03-05 -f md
对于中转：始终通过检查 JSON 输出中的 fromStation 和 toStation 来验证两个行程段是否使用相同的车站。

数据直接来自 12306 官方 API（无需密钥）
车站数据缓存在 {baseDir}/data/stations.json 中，为期 7 天
适用于所有列车类型：G（高铁）、D（动车）、Z（直达）、T（特快）、K（快速）

Lark Skill Maker 教程：基于飞书CLI创建AI技能，自动化工作流与API调用指南