12306 列车查询

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

查询车票

node {baseDir}/scripts/query.mjs <出发地> <目的地> [选项]

• HTML 模式（默认）：生成 HTML 文件，并将文件路径输出至 stdout
• Markdown 模式（-f md）：以 Markdown 表格格式直接输出至 stdout（适用于对话场景）

示例

# 查询北京至上海所有车次（默认为今日）
node {baseDir}/scripts/query.mjs 北京 上海

# 输出 Markdown 表格（直接输出至 stdout，适合聊天场景）
node {baseDir}/scripts/query.mjs 北京 上海 -t G -f md

# 仅查询上午发车（06:00–12:00）、行程不超过 2 小时、且二等座有余票的车次
node {baseDir}/scripts/query.mjs 上海 杭州 -t G --depart 06:00-12:00 --max-duration 1h --seat ze

# 仅显示到达时间在 18:00 前、且当前可预订的车次
node {baseDir}/scripts/query.mjs 深圳 长沙 --available --arrive -18:00

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

# JSON 格式输出（直接输出至 stdout）
node {baseDir}/scripts/query.mjs 广州 武汉 --json

选项

• -d, --date ：乘车日期（默认为当天）
• -t, --type ：筛选车次类型（可组合使用，例如 GD）
• --depart ：出发时间范围（例如 08:00-12:00、18:00-）
• --arrive ：到达时间范围（例如 -18:00、14:00-20:00）
• --max-duration ：最大行程时长（例如 2h、90m、1h30m）
• --available：仅显示当前可预订的车次
• --seat ：仅显示指定席别有余票的车次（逗号分隔，支持：swz,zy,ze,rw,dw,yw,yz,wz）
• -f, --format ：输出格式 — html（默认，保存为文件）或 md（Markdown 表格输出至 stdout）
• -o, --output ：输出文件路径（仅 HTML 模式有效；默认为 {baseDir}/data/<出发地>-<目的地>-.html）
• --json：以原始 JSON 格式输出至 stdout

输出列说明

取值说明：数字 = 剩余座位数，有 = 有票（具体数量未知），— = 该席别不适用

车站查询

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

注意事项

• 数据直连 12306 官方 API（无需 API Key）
• 车站数据缓存在 {baseDir}/data/stations.json 中，有效期为 7 天
• 支持城市名称（自动解析为该城市主要车站）或精确车站名称
• 支持全部车次类型：G（高铁）、D（动车）、Z（直达）、T（特快）、K（快速）