核心用法
极速数据火车查询技能(jisu-train)是基于第三方极速数据平台火车查询API的OpenClaw工具,提供三类核心功能:
1. 站站查询(station2s):输入出发站与到达站,获取所有车次列表,含出发/到达时间、历时、里程及二等座/一等座票价
2. 车次查询(line):输入车次号,获取完整经停站信息,包括每站到发时间、停靠时长
3. 余票查询(ticket):指定日期与起止站,实时查询各席别余票数量
调用方式为命令行执行Python脚本,参数通过JSON字符串传递,需预先配置JISU_API_KEY环境变量。
显著优点
- 功能聚焦:覆盖出行决策关键信息(时刻、价格、余票),无需多平台跳转
- 数据维度全:同时提供历时、里程、多席别票价,便于综合比价
- 接口简洁:JSON入参、结构化出参,易于程序化解析
- 实时性:余票查询直接对接铁路数据,时效性优于静态时刻表
潜在局限
- 第三方依赖:数据来源于极速数据平台,非12306官方直连,存在数据延迟或覆盖盲区风险
- 付费门槛:需申请API Key,高频率调用可能产生费用
- 功能边界:不支持在线订票、改签等交易操作,仅作信息查询
- 日期限制:余票查询需明确指定日期,无法模糊查询"未来某天"
适合人群
- 需要批量查询列车信息的开发者或自动化工作流用户
- 希望快速比价、筛选车次的计划出行者
- 企业内部差旅系统集成场景
常规风险
- API密钥泄露:
JISU_API_KEY以环境变量存储,需避免泄露至日志或版本控制 - 数据准确性:第三方平台数据可能与12306存在偏差,关键出行建议二次核对
- 服务可用性:依赖极速数据平台稳定性,节假日高峰期可能出现限流或延迟