用途：查询纽约市实时交通信息，覆盖全部 496 个地铁站、16000+ 公交站、NYC Ferry 码头及 LIRR/Metro-North 车站。适用于查看到站时间、服务提醒与延误、按名称或线路搜索站点、规划地铁行程、查询公交到站与线路、渡轮时刻与提醒、通勤铁路发车等场景。
主要能力：地铁到站/提醒/站点搜索/行程规划/线路状态；公交到站、提醒、站点搜索、线路信息；渡轮到站、提醒、码头搜索、线路；铁路（LIRR/MNR）发车、提醒、车站搜索与车站信息。
使用方式：优先使用 CLI，它自动处理重试、鉴权并默认输出精简文本。安装：npm run build:cli，二进制位于 ./dist/subway-info；也可 npm run cli -- arrivals --station 127。示例：subway-info arrivals --station 127 --line 1 --direction N --limit 5；subway-info alerts --line A；subway-info stations --query "times square"；subway-info trip --from 127 --to 631；subway-info bus arrivals --stop 402940 --route M1；subway-info ferry arrivals --landing <id>；subway-info rail departures --station <id> --system LIRR。全局选项：--json、--api-key、--base-url。
REST API：基址 https://subwayinfo.nyc，数据端点均用 POST 加 JSON 体，如 /api/arrivals、/api/alerts、/api/stations、/api/station、/api/trip，以及 /api/bus/、/api/ferry/、/api/rail/*；健康检查为 GET /health。速率限制：匿名 10 次/分（按 IP），Free 60、Standard 300、Premium 1000（需 X-API-Key）。
限制与注意：数据可能被边缘缓存 5-10 秒，服务中断时预测可能回退为计划时间；到站端点不含服务提醒，需单独查询 alerts；站名可能重复，建议按线路过滤确认站点 ID；时间均为东部时间，需自行转换；周末与节假日班次不同；注意 429 限流并做退避重试。具体收费与价格暂未提供。