train-srt 사용 가이드

SRT(수서고속철) 열차를 찾고 예약하는 스킬입니다. 평소 말하듯 부탁하면 됩니다. (서울역에서 타는 KTX는 train-ktx을 쓰세요.)

⚠️ 실험적 스킬 — 배포하지 마세요#

이 스킬은 개인 학습·실험 목적으로 만든 것입니다. SR의 비공식 통로를 쓰기 때문에 SR 이용약관에 어긋날 수 있고, 그래서 다른 사람에게 배포하거나 공개 마켓플레이스에 올리지 않습니다. 직접 쓰실 때도 본인 계정·본인 책임이라는 점을 기억해 주세요. 동작 원리가 궁금하면 README.md를 참고하세요.

먼저 알아두세요#

• 이 스킬은 SR의 비공식 통로로 동작합니다. SR 사정에 따라 갑자기 안 될 수 있습니다. 그럴 때는 잠시 후 다시 시도하거나 SR 앱을 이용하세요.
• 이 스킬은 열차 찾기와 예약까지만 도와줍니다. 결제와 취소는 직접 하셔야 합니다. 예약해 두어도 정해진 시간 안에 SR 앱/홈페이지에서 결제하지 않으면 자리가 자동으로 풀립니다.
• 예약·결제·노쇼에 대한 책임은 본인에게 있습니다.
• 취소표를 자동으로 계속 노리는 매크로 기능은 제공하지 않습니다.

준비물#

SR 회원 계정이 필요합니다. 아직 없다면 SR 홈페이지(etk.srail.kr)에서 가입하세요.

가입 후, SR 아이디와 비밀번호를 Claude Desktop 지침에 등록해 두면 됩니다 — Claude Desktop → 설정 → 일반 → “Claude 지침” 에 아래 두 줄을 붙여넣고 저장하세요.

SRT_USER_ID=SR 회원번호 또는 휴대폰번호 또는 이메일
SRT_PASSWORD=SR 로그인 비밀번호

한 번 넣으면 이후 모든 대화에서 Claude가 자동으로 사용합니다 — .env 같은 파일을 직접 만들 필요가 없습니다. (아이디·비밀번호는 화면이나 기록에 그대로 드러나지 않도록 가려서 다룹니다. 특히 비밀번호는 본인만 보는 지침 영역에 두는 것이 안전합니다.)

개발자라면 작업 폴더·홈의 .env 파일이나 환경변수에 같은 두 줄을 넣어도 됩니다.

등록이 끝나면 확인해 보세요 — “SRT 계정 확인해줘”라고 말하면 로그인을 한 번만 시도해 계정이 맞게 설정됐는지 알려드립니다(아이디는 가려서 표시). 표를 구하려는 순간에 로그인 오류를 만나는 일을 막아 줍니다.

이렇게 말해보세요#

계정 확인

• “SRT 계정 확인해줘”
• “SR 로그인 되는지 봐줘”

열차 찾기

• “내일 수서에서 부산 가는 SRT 찾아줘”
• “오후 6시 이후에 동탄에서 동대구 가는 표 있어?”
• “다음 주 금요일 수서에서 광주송정 가는 SRT 알려줘”
• “어른 2명, 주말에 평택지제에서 부산 가는 SRT 보여줘”

SRT는 수서·동탄·평택지제에서 출발합니다. 서울·용산·광명에서 타는 열차는 KTX이니 그쪽은 train-ktx을 쓰세요.

예약하기

• “그중에 두 번째 열차로 예약해줘”
• “제일 빠른 걸로 잡아줘”
• “특실로 예약 가능해?”

예약은 두 단계로 진행됩니다#

안전을 위해 예약은 한 번에 끝내지 않습니다.

1. 먼저 어떤 열차를 잡을지 보여드립니다 — 시각, 구간, 좌석유형, 인원. (이 단계에서는 아직 예약되지 않습니다.)
2. 내용을 확인하고 “맞아, 예약해줘” 라고 승인하면 그때 실제로 예약합니다.

예약이 되면 예약번호와 결제기한을 알려드립니다. 그 시간 안에 SR 앱/홈페이지에서 직접 결제하세요.

결제와 취소#

• 결제: 이 스킬은 결제하지 않습니다. 예약 후 SR 앱/홈페이지에서 결제기한 안에 직접 하세요.
• 취소: 이 스킬은 취소하지 않습니다. SR 앱/홈페이지나 고객센터(1800-1472)에서 취소하세요. (결제 전 예약은 기한이 지나면 저절로 풀립니다.)

지금은 안 되는 것들#

• KTX(서울·용산·광명 출발)는 이 스킬 대상이 아닙니다 — train-ktx을 쓰세요.
• 갈아타는 여정(환승), 자동 결제, 자동 취소, 할인 최적화는 지원하지 않습니다.
• “자리 날 때까지 계속 시도해줘” 같은 반복 감시는 하지 않습니다. 필요할 때 그때그때 다시 찾아 달라고 하세요.

잘 안 될 때#

• “접속이 지연/차단”이 나오면 잠시 후 다시 시도하거나 SR 앱을 이용하세요.
• “로그인 필요”가 나오면 Claude 지침(또는 .env)에 넣은 아이디·비밀번호를 다시 확인하세요. 고친 뒤 “SRT 계정 확인해줘”라고 말하면 바로 검증할 수 있습니다.
• 원하는 시간대가 안 보이면 매진일 수 있습니다. 다른 시간대나 날짜로 다시 찾아보세요.