ktx-booking

The ktx-booking skill provides a structured workflow for searching, reserving, inspecting, and canceling KTX and Korail train reservations in Korea. It builds on the korail2 library and a dedicated helper script to restore and support the current Korail booking flow, including handling requirements related to recent anti-bot protections. The skill is designed to help users find available train services, review reservation options, manage existing bookings, and perform ticket cancellations without relying on unofficial scraping methods. It also enforces credential-based access through configured Korail account credentials and follows a defined credential resolution process.

Key capabilities include train schedule searches, reservation creation, reservation inspection, cancellation handling, support for multiple train categories through train-type selection, and management of waiting-list reservations when available. The workflow requires searching through the helper script before booking, presenting a shortlist of matching trains, and reserving only after a specific train identifier has been selected. The skill also supports N-card discount workflows, including listing available N-cards, searching discounted train options, and creating reservations using a selected N-card. Installation guidance, environment variable requirements, seat preferences, passenger information, and train identifier handling are included as part of the documented process.

Typical use cases include travelers searching for KTX routes between cities, users checking reservation status, customers canceling existing Korail reservations, and passengers looking for the earliest available train after a specific time. It is particularly useful for users who need N-card discounted reservations or who want access to non-KTX train categories supported by the workflow. The skill is intended for authenticated Korail account holders using Python-based tooling and does not automate final payment confirmation.