ktx-booking

Automate KTX and Korail ticket search, reservation, and cancellation.

Updated May 1, 2026
One-click install
npx skills add https://github.com/seolcoding/k-parent-skill --skill ktx-booking-seolcoding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ktx-booking
Source: https://github.com/seolcoding/k-parent-skill/tree/main/ktx-booking
Command: npx skills add https://github.com/seolcoding/k-parent-skill --skill ktx-booking-seolcoding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires korail2, pycryptodome, and includes scripts (resource) components.

What problem does it solve?

Manually searching for and booking KTX/Korail train tickets is time-consuming, and unofficial booking tools often break due to Korail's anti-bot measures, leaving users without a reliable automated option for managing their train reservations.

Core Features & Use Cases

  • Train Search: Find available KTX, ITX, Mugunghwa, and other Korail train types by route, date, departure time, and passenger count, including options to view sold-out trains and waiting list eligible trains.
  • Seat Reservation: Book seats directly using stable train IDs, with support for general and premium seat preferences, and waiting list reservation for sold-out trains.
  • Reservation Management: Check existing reservation details and cancel bookings as needed, with clear confirmation of all actions.
  • Use Case: A user planning a weekend trip from Seoul to Busan can quickly find the earliest available morning KTX, reserve seats for 2 passengers, and cancel the booking if their plans change, all without navigating the clunky Korail mobile app.

Quick Start

Use the ktx-booking skill to find and reserve the earliest available KTX from Seoul to Busan on 20260503 departing after 9 AM for 2 general passengers.

Frequently Asked Questions about ktx-booking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate KTX train ticket booking while bypassing Korail anti-bot restrictions?

Automated KTX train ticket booking bypasses Korail anti-bot restrictions by using the korail2 and pycryptodome packages to handle search, reservation, and cancellation operations programmatically. This approach maintains stable access where unofficial booking tools typically break.

Can I search for sold-out Korail trains and join a waiting list automatically?

Yes, Korail train searches can view sold-out trains and check waiting list eligibility. When trains are sold out, the reservation system supports booking seats directly via the waiting list for specified routes, dates, and passenger counts.

What do I need to set up before using a Python script to reserve Korean rail tickets?

To reserve Korean rail tickets, you need Python 3.10 or higher, the korail2 and pycryptodome packages installed, and valid Korail user credentials. Credentials must be stored in environment variables or secure secret storage before running the script.

How do I manage and cancel existing Korail train reservations programmatically?

Managing and canceling existing Korail train reservations programmatically involves fetching reservation details and executing cancellation commands. The system provides clear confirmation of all inspection and cancellation actions applied to your bookings.

Does automated Korail booking support group travelers and premium seat selection?

Automated Korail booking supports group travelers by allowing you to specify passenger counts during the train search. You can also indicate seat preferences for general or premium seats when reserving seats using stable train IDs.

Why do unofficial Korail booking tools break and fail to complete train reservations?

Unofficial Korail booking tools break because Korail implements Dynapath anti-bot measures that block automated requests. This Skill overcomes Dynapath restrictions by utilizing the pycryptodome package to maintain stable search and reservation functionality.