用途:在韩国铁路 KTX/Korail 上查询、预约、查看和取消车票,通过 scripts/ktx_booking.py 辅助脚本封装 korail2-ncard,并补充 x-dynapath-m-token、Sid 与最新 app version(250601002),以应对 Korail 应用新增的 Dynapath 反爬校验。
主要能力:车次查询(支持 ktx、itx-saemaeul、mugunghwa、nuriro、tonggeun、itx-cheongchun、airport、all 等列车类型);按稳定 train_id 预约指定车次;查看已有预约;取消预约;N 卡折扣车次查询与折扣预约(ncard-list、ncard-search、reserve 加 --ncard-index)。可附带 --include-no-seats、--include-waiting-list 显示无座及可候补车次,预约时用 --try-waiting 尝试候补。
使用方式:需 Python 3.10+,先安装依赖:python3 -m pip install korail2-ncard pycryptodome。设置环境变量 KSKILL_KTX_ID、KSKILL_KTX_PASSWORD,也可从本地密钥库注入或使用 ~/.config/k-skill/secrets.env(权限 0600)。查询示例:python3 scripts/ktx_booking.py search 서울 부산 20260328 090000 --limit 5;预约时复制查询结果中的 train_id:python3 scripts/ktx_booking.py reserve 서울 부산 20260328 090000 --train-id <train_id> --seat-option general-first;查看与取消:reservations、cancel <reservation_id>。非 KTX 车次在查询与预约阶段均需传入相同的 --train-type;N 卡预约需用 ncard-list 获取卡序号,--ncard-index 会忽略 --adults 等乘客选项。
适用场景:首尔至釜山等 KTX 行程查询与订票、预约确认、取消,以及应用 N 卡折扣的车次查找与预约。
限制:不适用于 SRT;支付环节不自动完成;不要用明文凭据或激进轮询;可能出现登录失败、售罄、Korail 反爬规则变更导致失败;N 卡功能依赖 korail2-ncard 包。资料未提供收费、价格及其他平台支持信息。