xby-12306-ticket-purchase-search
在终端中运行以下命令:
dsh plugin install xby-skill/xby-12306-ticket-purchase-search
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 终端中执行 dsh plugin install xby-skill/xby-12306-ticket-purchase-search 即可安装该插件,完整源码见 https://github.com/xby-skill/xby-12306-ticket-purchase-search
插件介绍
大语言模型本身并不具备调用 12306 铁路票务系统的能力。当用户问一句"明天北京到上海有哪些火车",模型只能给出模板式的模糊回答,无法返回真实的余票、车次和时刻。xby-12306-ticket-purchase-search 将 12306 购票搜索封装为一组基于 Model Context Protocol (MCP) 的结构化工具,让模型能够通过真实 API 调用直接查询余票、中转方案和列车经停信息,从根本上补齐了出行场景的关键数据缺口。
插件覆盖了从自然语言到结构化查询的完整链路:通过中文城市名或具体车站名解析 station_code,以上海时区(Asia/Shanghai, UTC+8)解析"明天""下周三"等相对日期,查询直达列车余票,获取前十条中转方案,以及特定车次在指定区间的经停站、到站时间、出发时间和停留时间。此外还提供 telecode 反查用于调试。API 密钥仅需在对话中设置一次,自动持久化,重启后依然有效,无需反复配置。
适合正在构建旅行、出行类 AI Agent 的开发者,以及需要铁路票务能力的编排平台或消费级产品团队。使用前提是在小笨羊(xby)官网注册并获取 API 密钥。项目采用 MIT 协议开源,代码可自由集成与二次开发。
使用场景
- 用户询问两城之间火车余票与车次时,模型可直接调用接口返回真实数据
- 用户需要中转方案时,插件返回前十条中转余票记录供选择
- 用户想了解某趟列车的经停站、到发时间和停留时长时,插件提供详细区间信息
适合人员
- 构建旅行或出行类 AI Agent 的开发者
- 需要铁路票务数据能力的消费级产品团队
- 集成 MCP 工具链的编排平台工程师