ticket-availability

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

YES24 / 인터파크 공연의 공개 일정 + 등급별 잔여석을 단일 HTTP 호출로 조회 (조회 전용, 예매·결제 없음).

6installs
Sourcenomadamas/k-skill
Added on

NPX Install

npx skill4agent add nomadamas/k-skill ticket-availability

Tags

Translated version includes tags in frontmatter
ticket-availabilityyes24interparkpython-toolhttpx

SKILL.md Content

View Translation Comparison →

Ticket Availability

What this skill does

YES24 (
ticket.yes24.com
) 와 인터파크 (
tickets.interpark.com
) 의 공개 BFF JSON / Ajax endpoint 를 단일 HTTP 요청으로 호출해 공연 일정과 등급별 잔여석 수를 정규화한다.
  • 공연 URL 또는 
    platform:id
    표기로 입력을 받는다.
  • 일정 (날짜·시간·회차) 조회.
  • 등급별 잔여석 수 조회 (등급명, 잔여수, YES24의 경우 노출가).
  • 좌석맵 / 좌석 선택 / 예매 / 결제 / 로그인 세션 접근은 하지 않는다.
  • CloakBrowser, Playwright, fingerprint spoofing, CAPTCHA 우회를 사용하지 않는다 (
    httpx
    only).

When to use

  • "오늘 인터파크 ○○ 공연 잔여석 있어?"
  • "YES24 콘서트 ID 58026 일정 알려줘"
  • "이 공연 R석 몇 자리 남았어?"
  • "공연 URL 줄게, 회차별 잔여석 확인해줘"

When not to use

  • 예매·결제·취소·환불 처리 — 공연법 §4조의2 (2023.9 시행) 매크로 입장권 부정구매·판매 금지 대상이며 이 스킬은 의도적으로 예매를 지원하지 않는다.
  • 좌석 선택, 좌석맵 시각화, 특정 좌석 번호 확인 — 잔여 수 만 노출한다.
  • 회원 등급별 우선 예매, 쿠폰가, 카드사 할인가 — 공개 endpoint 만 사용한다.
  • 차단 우회, CAPTCHA 우회, headless 감지 우회 — 
    httpx
    한 호출로 안 되면 실패 모드로 처리하고 종료한다.

Required inputs

공연 URL 또는 
platform:id
표기가 없으면 먼저 물어본다.
권장 질문:
확인하실 공연의 YES24 또는 인터파크 URL을 알려주세요. 예: 
https://tickets.interpark.com/goods/26000541
https://ticket.yes24.com/Perf/58026

Prerequisites

  • Python 3.9+
  • httpx
    (표준 패키지)
설치:
bash
pip install httpx

Workflow

1. URL 파싱

입력매칭
https://tickets.interpark.com/goods/<goods_code>
platform=interpark
https://ticket.yes24.com/Perf/<perf_id>
platform=yes24
https://ticket.yes24.com/New/Perf/Detail/View/<perf_id>
platform=yes24
yes24:<id>
/ 
interpark:<id>
shorthand

2. 일정 조회 (
schedule
)

bash
python3 scripts/ticket_availability.py schedule "https://tickets.interpark.com/goods/26000541"
응답 — Interpark:
json
{
  "platform": "interpark",
  "id": "26000541",
  "schedule": [
    {"date": "2026-05-13", "time": "14:30", "play_seq": "055"},
    {"date": "2026-05-14", "time": "19:30", "play_seq": "057"}
  ]
}
응답 — YES24:
json
{
  "platform": "yes24",
  "id": "58026",
  "schedule": [
    {"date": "2026-05-16", "time_label": "1회", "id_time": "1432397"}
  ]
}
YES24 는 기본 3주 윈도우. 6개월 전체는 
--all-dates
추가.

3. 잔여석 조회 (
seats
)

bash
python3 scripts/ticket_availability.py seats "interpark:26000541"
응답:
json
{
  "platform": "interpark",
  "id": "26000541",
  "seats": {
    "2026-05-13|14:30|055": {
      "date": "2026-05-13", "time": "14:30", "play_seq": "055",
      "seats": [
        {"grade": "VIP석", "remain": 150},
        {"grade": "R석",  "remain": 36},
        {"grade": "S석",  "remain": 82},
        {"grade": "A석",  "remain": 71}
      ]
    }
  }
}
YES24 응답은 등급별 
price
(노출가) 도 포함:
json
{"grade": "전석", "price": "110,000원", "remain": 2}

4. 헬스체크 (
health
)

bash
python3 scripts/ticket_availability.py health
응답:
json
{"yes24": {"status": 200, "ok": true}, "interpark": {"status": 200, "ok": true}}

Output format

기본 출력은 들여쓰기 JSON. 파이프/스크립트용은 
--compact
추가 (한 줄 JSON).

Endpoints used

이 스킬이 호출하는 공개 endpoint 만:
PlatformMethodURL
YES24POST
https://ticket.yes24.com/New/Perf/Sale/Ajax/axPerfDay.aspx
YES24POST
https://ticket.yes24.com/NEw/Perf/Detail/Ajax/axPerfPlayTime.aspx
YES24POST
https://ticket.yes24.com/New/Perf/Detail/Ajax/axPerfRemainSeat.aspx
InterparkGET
https://api-ticketfront.interpark.com/v1/goods/<id>/playSeq
InterparkGET
https://api-ticketfront.interpark.com/v1/goods/<id>/playSeq/PlaySeq/<seq>/REMAINSEAT
전부 비로그인 / 무인증. 헤더는 
User-Agent
+ 
Referer
+ JSON 
Accept
만.

Failure modes

  • YES24 
    schedule
    결과 빈 배열    : 공연 ID 가 유효하지만 향후 3주(또는 6개월) 내 일정이 없음. ID 자체가 잘못된 경우와 구분되지 않으므로, 사용자에게 
    --all-dates
    또는 다른 ID 확인을 안내한다.
  • Interpark 
    data: []
    : goods_code 가 지나갔거나 아직 오픈 전 / 비공개. 다른 ID 확인을 안내한다.
  • HTTP 4xx/5xx: 차단/일시 장애. 우회 시도하지 않고 
    http error
    출력 후 종료.
  • JSON 스키마 변경: YES24 axPerfRemainSeat 는 HTML 응답을 정규식으로 파싱 — 사이트 갱신 시 영향 가능. 
    remain
    0 으로 잘못 보고될 수 있어 사용자에게 "조회 시각 기준" 이라고 표기.
  • 공연 매진: API 는 
    remain: 0
    반환. 매진 표시.

Response style

  • 잔여석은 "조회 시각 기준" 으로 표현한다 (실시간 변동).
  • "매크로", "선점", "오픈런", "자동 예매" 표현 금지 — 이 스킬은 조회 전용.
  • 잔여석 수치 + 등급명 만 인용. 좌석 번호 / 좌석 위치는 노출하지 않는다.
  • "지금 사라" 같은 행위 유도 금지 — 사용자가 직접 페이지에서 결제.

Notes

  • 본 스킬은 의도적으로 예매 / 결제 / 좌석선택 / 로그인 자동화 를 포함하지 않는다. 매크로를 통한 입장권 부정구매·판매는 공연법 §4조의2 (2023.9.22 시행) 에 의해 형사처벌 대상.
  • 시크릿 / 키 / 로그인 세션 일체 사용하지 않는다.
  • Rate limit: 
    seats
    명령은 회차별 순차 호출 — Interpark 0.3s, YES24 0.4s 간격. 100회차 짜리 공연이면 약 30s ~ 40s 소요. 짧은 모니터링 루프에 넣지 말 것.

Done when

  • 공연 URL 또는 
    platform:id
    가 확인되었다.
  • 일정 또는 잔여석 결과 JSON 을 반환하거나, 빈 결과 사유를 설명했다.
  • 예매 / 결제 / 좌석 선택 기능을 자동화하지 않았다.
  • 조회 시각 기준임을 안내했다.