12306-skill
无需API密钥，命令行直接查询12306列车时刻与余票
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：12306-skill。 它的用途是：无需API密钥，命令行直接查询12306列车时刻与余票 完整的 Skill 内容见：https://321skill.com/skills/12306-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下明天下午从北京到上海的高铁，只要出发时间在2点以后的，用Markdown表格展示。” AI会调用该Skill，执行类似 `node scripts/query.mjs 北京 上海 -d 2024-xx-xx --depart 14:00- -t G -f md` 的命令，并将清晰的列车时刻与余票表格返回给你。
介绍
这是一个专门用于查询中国铁路12306列车信息的命令行工具。它解决了用户需要快速、便捷地获取官方列车时刻、余票和车站信息，而无需依赖官方App或网页端复杂操作的问题。
用户只需在命令行中输入出发地、目的地及可选参数（如日期、车次类型、时间范围等），即可获取详细的列车信息。工具支持HTML文件输出、Markdown表格输出以及JSON原始数据输出，方便不同场景下的查看与处理。
该工具非常适合需要频繁查询火车票信息的开发者、经常出差的商务人士、旅行规划者，或者任何希望用脚本自动化处理铁路信息的用户。它通过命令行提供了比手动操作更高的效率和灵活性。
与同类工具相比，它的核心优势在于完全开源、无需申请和配置复杂的API密钥，直接模拟查询流程获取官方数据。同时，它提供了丰富的过滤选项和多种输出格式，兼顾了易用性与功能性。
核心特点
核心区别在于：1) 完全开源且无需任何API密钥或认证，开箱即用；2) 提供强大的本地过滤功能（如按发车时间、座位类型、最长耗时等），能在获取数据后立即进行精细化筛选，而无需反复查询。
注意事项
不适合需要实时、100%准确官方余票状态（如秒杀抢票）或在线支付购票的场景，主要用于信息查询与行程规划。
常见问题
查询武汉到上海的高铁，为什么结果里包含了汉口站和武汉站？
因为输入城市名（如“武汉”）会查询该城市所有车站。为确保准确，请先用 stations.mjs 查清具体车站名，再用精确站名查询。
这个工具能直接买票吗？
不能。这是一个信息查询工具，仅用于查询列车时刻、余票和车站信息，不支持登录、下单和支付等购票操作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/12306-skill/raw/index.md 读取 12306-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/12306-skill/raw/index.md（查看排版版本）