12306 Train Query

核心功能

12306技能提供中国国铁官方票务查询能力，支持以下核心用法：

• 余票查询：输入出发地、目的地、日期（可选）及车次类型，实时返回各席别余票数量
• 车站检索：模糊匹配车站名称，自动解析城市名至主站
• 车次筛选：支持G（高铁）、D（动车）、Z（直达）、T（特快）、K（快速）及组合过滤

显著优点

1. 官方数据源：直接对接12306开放API，非爬虫抓取，数据实时性与准确性有保障
2. 零配置使用：无需API密钥或账号登录，开箱即用
3. 多输出格式：默认表格友好展示，支持--json原始数据供二次开发
4. 智能站名解析：支持城市名（如"北京"自动映射至北京南站/西站等主站）或精确站名
5. 全席别覆盖：商务座至无座全量展示，状态符号（✅/❌）直观可读

局限性与注意事项

• 购票限制：仅支持查询，无法直接购票，需跳转12306官网/APP完成支付
• 缓存机制：车站数据缓存7天，新建车站可能存在识别延迟
• 并发瓶颈：高峰期查询可能受限于12306接口限流
• 日期边界：需指定YYYY-MM-DD格式，不支持自然语言日期（如"明天"需手动转换）

适合人群

| 场景 | 说明 |

|------|------|

| 差旅规划 | 快速比选多车次余票，制定行程方案 |

| 开发者 | 获取结构化JSON数据，集成至自动化工作流 |

| 代购协助 | 实时盯票提醒，辅助抢票决策 |

常规风险提示

• 非购票渠道：本技能仅提供信息查询，任何涉及支付、身份认证的环节务必返回官方平台操作，谨防钓鱼链接
• 个人信息：查询本身不采集用户信息，但后续购票环节需注意12306官方的隐私政策
• 时效性：余票数据为查询瞬间状态，热门线路建议高频刷新或启用候补功能

核心用法

12306 Skill 是一款专为中国铁路出行场景设计的查询工具，通过直连官方 API 获取实时列车时刻表与余票信息。用户只需提供出发地、目的地及日期，即可快速检索所有车次；支持按列车类型（G高铁、D动车、Z直达、T特快、K快速）精准筛选，并可输出 JSON 格式供二次开发。

显著优点

• 官方数据源：直接对接 12306.cn 官方 API，数据实时准确，无中间商加价或信息延迟
• 零认证门槛：无需账号登录、无需验证码、无需 API Key，即查即用
• 多维度筛选：支持日期指定、车型组合过滤（如 -t GD 仅查高铁+动车）、城市名智能解析
• 轻量无依赖：纯 Node.js 原生实现，零第三方依赖，部署成本低

潜在局限

• 功能边界有限：仅支持查询，无法完成购票、改签、退票等交易操作
• 站名解析容错：城市名自动映射至主站（如"北京"→"北京南站"），特殊需求需输入完整站名
• 缓存更新周期：车站数据缓存 7 天，新建车站或更名站可能存在短暂滞后
• 反爬风险：高频查询可能触发 12306 限流（虽目前未加入请求频率限制）

适合人群

• 需要快速比价、规划行程的商务/旅游出行者
• 开发火车票相关应用的开发者（JSON 输出便于集成）
• 不便安装官方 App 的轻量用户（命令行场景）

常规风险

• 隐私披露：查询请求含出发站、到达站、日期，会传输至 12306 官方服务器（HTTPS 加密）
• 服务稳定性：依赖 12306 官方服务可用性，节假日高峰期可能响应延迟
• 结果时效性：余票数据为查询瞬间快照，热门车次售罄迅速，需以购票页面为准

> 数据来源：CocoLoop Safe (CLS) Security Lab 认证报告 CLS-2026-0605-12306-A
> 安全评级：A级（95分）｜信任等级：T3（个人/社区项目）｜证书有效期：90天