Srt Booking
Automate Korea SRT seat search, reservation, status checks, and cancellations through the SRTrain Python library with agent-safe credential handling.
Overview
srt-booking is an agent skill for the Build phase that searches, reserves, inspects, and cancels Korea SRT tickets using the SRTrain library and secured environment credentials.
Install
npx skills add https://github.com/nomadamas/k-skill --skill srt-bookingWhat is this skill?
- Search SRT availability by station pair, `YYYYMMDD` date, and `HHMMSS` departure window
- Reserve and cancel tickets via SRTrain when seats match passenger count and seat class preferences
- Four-step credential resolution: env vars, agent secret vault, `~/.config/k-skill/secrets.env` (0600), or prompt-and-sto
- Hard rule: install `SRTrain` globally with pip when import fails—no ad-hoc website scraping bypass
- Explicit when-not-to-use guardrails: no auto-payment completion, no chat plaintext passwords, not for KTX/Korail
- Requires Python 3.10+
- Credential fallback path `~/.config/k-skill/secrets.env` with permission 0600
- Documents a 4-step credential resolution order
Adoption & trust: 2.7k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need SRT seats on a specific corridor and time but manual refresh and booking on the site is slow and hard to drive from an agent session.
Who is it for?
Korea-based builders automating personal or small-team SRT travel with Python 3.10+ and willingness to manage SRT login secrets locally.
Skip if: Users who need KTX/Korail, end-to-end payment automation, or who paste passwords directly into the chat instead of env/vault setup.
When should I use this skill?
The user asks for SRT seat availability, booking, reservation lookup, cancellation, or sold-out retry plans in Korea (not KTX/Korail).
What do I get? / Deliverables
The agent returns availability, completes reservation or cancellation actions through SRTrain when rules match, and keeps credentials in env or vault—not in chat.
- Seat search results for the requested corridor and time window
- Reservation or cancellation confirmation tied to the user’s SRT account
- Retry or monitoring plan when trains are sold out
Recommended Skills
Journey fit
The skill packages an external rail API integration you implement and operate as part of your agent toolchain. It connects to SRTrain/SRT backends with env-based secrets—classic third-party integration work, not frontend or launch distribution.
How it compares
Use for library-backed SRT automation—not a general travel concierge or browser-only scraping skill.
Common Questions / FAQ
Who is srt-booking for?
Solo builders and travelers in Korea who want an agent-driven SRT workflow with SRTrain, structured dates, and secure credential injection.
When should I use srt-booking?
Use it during Build integrations when you wire personal automation: finding seats (e.g. Suwon-area to Busan), booking tomorrow morning slots, checking reservations, or canceling a hold.
Is srt-booking safe to install?
It requires SRT account secrets and network access to rail APIs; never send passwords in chat, lock down secrets files, and review the Security Audits panel on this Prism page.
SKILL.md
READMESKILL.md - Srt Booking
# SRT Booking ## What this skill does `SRTrain` 위에서 SRT 좌석을 조회하고, 조건이 맞으면 예약과 취소까지 진행한다. ## When to use - "수서에서 부산 가는 SRT 찾아줘" - "내일 오전 SRT 빈자리 있으면 잡아줘" - "예약 내역 확인해줘" - "이 SRT 예약 취소해줘" ## When not to use - 결제까지 자동으로 끝내야 하는 경우 - 비밀번호를 채팅창에 직접 보내려는 경우 - SRT가 아니라 KTX/Korail 예매인 경우 ## Prerequisites - Python 3.10+ - `python3 -m pip install SRTrain` ## Required environment variables - `KSKILL_SRT_ID` - `KSKILL_SRT_PASSWORD` ### Credential resolution order 1. **이미 환경변수에 있으면** 그대로 사용한다. 2. **에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면** 거기서 꺼내 환경변수로 주입해도 된다. 3. **`~/.config/k-skill/secrets.env`** (기본 fallback) — plain dotenv 파일, 퍼미션 `0600`. 4. **아무것도 없으면** 유저에게 물어서 2 또는 3에 저장한다. 기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다. ## Inputs - 출발역 - 도착역 - 날짜: `YYYYMMDD` - 희망 시작 시각: `HHMMSS` - 인원 수와 승객 유형 - 좌석 선호: 일반실 / 특실 ## Workflow ### 0. Install the package globally when missing `python3 -c 'import SRT'` 가 실패하면 다른 구현으로 우회하지 말고 전역 Python 패키지 설치를 먼저 시도한다. ```bash python3 -m pip install SRTrain ``` ### 1. Ensure credentials are available `KSKILL_SRT_ID`, `KSKILL_SRT_PASSWORD` 환경변수가 설정되어 있는지 확인한다. 없으면 위 credential resolution order에 따라 확보한다. 시크릿이 없다는 이유로 웹사이트를 직접 긁거나 다른 비공식 경로를 찾지 않는다. ### 2. Search first 먼저 조회해서 후보를 요약한다. ```bash python3 - <<'PY' import os from SRT import SRT srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"]) trains = srt.search_train("수서", "부산", "20260328", "080000", time_limit="120000") for idx, train in enumerate(trains[:5], start=1): print(idx, train) PY ``` ### 3. Summarize options before side effects 예약 전에는 항상 아래를 짧게 정리한다. - 출발/도착 시각 - 일반실/특실 가능 여부 - 예상 운임 ### 4. Reserve only after the train is fixed 예약은 부작용이 있으므로 정확한 열차를 고른 뒤에만 진행한다. ```bash python3 - <<'PY' import os from SRT import Adult, SRT, SeatType srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"]) trains = srt.search_train("수서", "부산", "20260328", "080000", time_limit="120000") reservation = srt.reserve( trains[0], passengers=[Adult(1)], special_seat=SeatType.GENERAL_FIRST, ) print(reservation) PY ``` ### 5. Inspect or cancel 취소 전에는 대상 예약을 다시 식별한다. ```bash python3 - <<'PY' import os from SRT import SRT srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"]) reservations = srt.get_reservations() print(reservations) PY ``` ## Done when - 조회 요청이면 후보 열차가 정리되어 있다 - 예약 요청이면 예약 결과, 운임, 구입기한이 확인되어 있다 - 취소 요청이면 어떤 예약을 취소했는지 명확하다 ## Failure modes - 로그인 오류: 계정 정보나 SRT site policy 변경 가능성 확인 - 매진: 다른 시간대나 좌석 타입으로 재조회 - 네트워크 오류: 짧게 재시도하되 aggressive polling은 피하기 ## Notes - `SRTrain`은 SRT 전용 라이브러리라서 스킬 의도가 더 선명하다 - 결제 완료까지는 자동화하지 않는다 - 자동 재시도 루프는 계정 보호 차원에서 짧고 보수적으로 유지한다