核心功能
irail-cli 是面向比利时国家铁路（NMBS/SNCB）的官方命令行工具，通过公开的 iRail API 提供无需认证的实时数据访问。核心能力覆盖六大场景：
1. 实时站台信息（liveboard）：查询任意车站的到发车时刻，支持延误标红、站台变更标黄的可视化输出
2. 智能路线规划（connections）：支持"出发时间"或"到达时间"双模式，可限定直达或联程方案
3. 列车详情追踪（vehicle/composition）：获取车次完整停靠站及车厢设施配置
4. 服务异常监控（disturbances）：区分计划性施工与突发故障两类通告
显著优势
- 零门槛接入：无需 API Key 或注册流程，开箱即用
- 灵活的 station 匹配：支持大小写不敏感的部分匹配（如
bruss匹配Brussel-Centraal） - 双语输出友好：原生支持荷兰语/法语/英语/德语四种界面语言
- 脚本化友好：
--json标志配合jq可实现完整的自动化工作流
局限性与风险
- 地理局限：仅覆盖比利时境内铁路网络，跨境国际列车信息可能不完整
- 数据依赖：iRail API 为非官方第三方数据源，极端情况下可能与 NMBS 官方渠道存在延迟或差异
- 频率限制：文档提示循环调用需自行添加延迟，暗示存在隐性速率限制
- 无实时座位状态：仅提供车厢设施配置，无法查询余票或预订座位
适用人群
- 比利时通勤者及跨境旅客的行程规划
- 开发者构建铁路信息自动化监控（如延误预警机器人）
- 数据分析师进行列车准点率统计研究
安全风险
API 端点公开且无需认证，不存在凭证泄露风险；但需注意输出中可能包含的准确实时位置信息在隐私敏感场景下的使用合规性。