直连12306官方API查询火车票余票与时刻表，支持多维度筛选与多种输出格式，无需密钥。
说明：
## 核心用法
本工具通过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服务器，内网或境外网络环境可能受限
会员专属
