디트릭스 예매 플랫폼을 사용하는 극장의 상영작, 상영 가능 날짜, 회차별 잔여 좌석을 조회합니다. 공개 원본 API를 직접 사용하며 Zyte나 별도 API 키가 필요하지 않습니다.
MCP 도구는 dtryx_list_cinemas, dtryx_list_now_showing, dtryx_get_remaining_seats입니다. 예를 들어 “서울 독립영화관에서 오늘 상영하는 영화와 잔여 좌석을 찾아줘”라고 요청할 수 있습니다.
npx daiso get /api/dtryx/cinemas --region 서울
npx daiso get /api/dtryx/movies --keyword 모모 --includePlayDates true
npx daiso get /api/dtryx/seats --region 서울 --movieName 경멸 --limit 20- 상영작 조회에는
cinemaCode또는 극장명keyword가 필요합니다. 검색 결과가 여러 곳이면 첫 번째 극장을 선택하므로 정확한 조회에는 극장 코드를 쓰세요. - 회차 조회에 극장 조건이 없으면 카탈로그 전체를 조회합니다.
region,keyword,brandCode를 함께 쓰면 모든 조건에 맞는 극장만 조회합니다. playDate는YYYYMMDD또는YYYY-MM-DD를 받으며 생략하면 한국 날짜 기준 오늘입니다. 원본에는 하이픈 날짜로 전달합니다.limit은 1200,60000 정수이며 기본값은 각각 50, 15000입니다.timeoutMs는 1- 일부 극장 조회가 실패하면 성공한 회차와
failedCinemas를 함께 반환합니다. 모든 극장 조회가 실패하면 API는 503, MCP는 오류를 반환합니다. 성공적으로 조회한 날에 편성이 없으면 빈 목록일 수 있습니다.
현재 확인된 극장 22곳을 src/services/dtryx/location.ts에서 관리합니다. 전체 제휴 극장 목록을 보장하지 않습니다. 폐업·이전·신규 입점 여부를 정기적으로 확인해야 합니다. 좌표가 없어 거리순 조회는 제공하지 않습니다.
카탈로그에 없는 극장도 공식 cinemaCode와 brandCode를 함께 알고 있으면 조회할 수 있습니다. 좌석은 조회 시점의 원본 정보로, 예매 과정에서 달라질 수 있습니다.
기존 메가박스 API에 전용 CLI 명령을 추가했습니다.
npx daiso megabox-theaters 강남 --limit 3
npx daiso megabox-movies --theaterId 1372
npx daiso megabox-seats --theaterId 1372 --limit 10디트릭스는 위의 범용 get 명령을 사용합니다. API 명세와 Actions에도 디트릭스 경로가 포함돼 있습니다.