官方直连·实时查票·多维筛选

直连12306官方API查询火车票余票与时刻表，支持多维度筛选与多种输出格式，无需密钥。

基本信息

• 技能名称?12306 Train Query
• 中文名称?官方直连·实时查票·多维筛选
• 作者?kirorab
• 分类?专业技能
• 版本?1.0.2
• 标签?railway, travel, 12306, train-query, transportation, public-api, china-domestic

使用方法

使用说明
核心用法
本工具通过Node.js脚本直连中国铁路12306官方API，实现火车票查询功能。主要包含两大模块：

1. 车票查询（query.mjs）
   基础查询： node {baseDir}/scripts/query.mjs
   支持城市名自动解析为主站，或精确输入车站名
   日期默认为当日，可通过 -d 指定具体日期
   输出格式灵活：HTML文件（默认）、Markdown表格（ -f md ）、原始JSON（ --json ）
2. 车站查询（stations.mjs）
   用于查询车站代码，如 node {baseDir}/scripts/stations.mjs 杭州
   显著优点
   官方数据源 ：直连12306 API，无需注册或API密钥，数据实时准确
   筛选功能丰富 ：支持按车型（G/D/Z/T/K）、出发/到达时段、最大行程时长、余票状态、座位类型等多维度过滤
   输出格式多样 ：满足不同场景需求——HTML适合浏览器查看，Markdown适合聊天嵌入，JSON便于二次开发
   智能缓存 ：车站数据缓存7天，减少重复请求
   轻量依赖 ：仅需Node.js环境，无额外运行时负担
   潜在缺点与局限性
   地域限制 ：仅覆盖中国铁路系统，不支持国际列车或港澳台地区（除香港西九龙等已纳入12306的站点）
   无购票功能 ：纯查询工具，无法完成实际订票、支付、改签等操作
   座位代码需记忆 ：座位类型使用缩写（swz/zy/ze等），对用户有一定学习成本
   时间格式严格 ：时间范围需符合 HH:MM 格式，不支持自然语言如"早上"
   依赖12306稳定性 ：高峰期可能受官方接口限流或维护影响
   适合人群
   经常需要查询火车时刻与余票的商务人士
   开发行程规划工具的开发者（JSON输出便于集成）
   偏好命令行效率的技术用户
   需要批量查询或自动化报告的场景
   常规风险
   数据隐私 ：查询行为经过12306官方服务器，虽无需登录，但IP和查询记录可能被记录
   时效性风险 ：余票数据存在短暂延迟，热门时段建议最终决策前二次确认
   脚本安全性 ：需确保 {baseDir}/scripts/ 目录下脚本来源可信，避免被篡改植入恶意代码
   网络依赖 ：必须连通12306服务器，内网或境外网络环境可能受限