名称： ns-trains
描述： 使用 NS API 查询荷兰列车时刻表、出发信息、运行中断情况并规划行程。非常适合日常通勤查询。
元数据： {"openclaw":{"emoji":"🚆","requires":{"bins":["node"],"env":["NS_SUBSCRIPTION_KEY"]},"primaryEnv":"NS_SUBSCRIPTION_KEY"}}

NS 列车技能

使用荷兰铁路公司 (NS) 的官方 API，查询列车时刻表、出发信息、运行中断情况并规划行程。

设置

1. 获取 NS 订阅密钥

1. 访问 NS API 门户网站。
2. 创建账户并订阅 Ns-App 产品（提供免费套餐）。
3. 复制您的 主密钥。

2. 设置环境变量

export NS_SUBSCRIPTION_KEY="您的订阅密钥"   # 推荐方式
# 向后兼容：
export NS_API_KEY="$NS_SUBSCRIPTION_KEY"    # 仍支持旧名称

# 可选：配置通勤车站以使用快捷方式
export NS_HOME_STATION="Utrecht Centraal"
export NS_WORK_STATION="Amsterdam Zuid"

出于安全考虑，建议通过运行时的密钥管理机制注入这些环境变量，而不是将其提交到任何地方。请勿打印或分享您的订阅密钥。

快速使用

🚆 通勤快捷方式

node {baseDir}/scripts/commute.mjs --to-work   # 早晨：家 → 工作地
node {baseDir}/scripts/commute.mjs --to-home   # 晚上：工作地 → 家

规划任意行程

node {baseDir}/scripts/journey.mjs --from "Utrecht Centraal" --to "Amsterdam Zuid"

查询车站的出发列车

node {baseDir}/scripts/departures.mjs --station "Amsterdam Centraal"

查询车站的到达列车

node {baseDir}/scripts/arrivals.mjs --station "Rotterdam Centraal"

搜索车站

node {baseDir}/scripts/stations.mjs amsterdam
node {baseDir}/scripts/stations.mjs --search "den haag"

查询当前运行中断情况

node {baseDir}/scripts/disruptions.mjs
node {baseDir}/scripts/disruptions.mjs --from "Utrecht" --to "Amsterdam"

自然语言查询

直接提问即可：
- “下一班去阿姆斯特丹的火车什么时候开？”
- “查一下从乌得勒支到鹿特丹的火车”
- “今天有列车运行中断吗？”
- “规划一下我去上班的通勤路线”
- “火车几点到站？”

输出内容

返回的行程选项包含：
- 出发/到达时间
- 实时延误信息
- 行程时长
- 换乘信息
- 站台号
- 运行中断警告
- 拥挤度预测（🟢 低 / 🟡 中 / 🔴 高）

命令参考

使用的 API 端点

• /reisinformatie-api/api/v3/trips - 行程规划
• /reisinformatie-api/api/v2/arrivals - 到达信息
• /reisinformatie-api/api/v2/departures - 出发信息
• /reisinformatie-api/api/v3/disruptions - 运行中断信息
• /reisinformatie-api/api/v2/stations - 车站搜索

参考

• NS API 门户网站：https://apiportal.ns.nl/
• 文档：https://apiportal.ns.nl/startersguide
• 免费套餐：5000 次请求/天