영화관 검색 가이드

원본 hmmhmmhm/daiso-mcp 와 npm package daiso 를 사용해 CGV, 메가박스, 롯데시네마의 영화관 검색, 상영작, 시간표, 잔여석 조회를 한다.

가장 중요한 규칙

k-skill 안에 별도 영화관 수집기를 추가하지 않는다.

기본 경로는 MCP 서버를 직접 설치하지 않고 CLI로 먼저 확인하는 방식이다.

npx --yes daiso ...
필요하면 git clone https://github.com/hmmhmmhm/daiso-mcp.git && cd daiso-mcp && npm install && npm run build
clone fallback에서는 node dist/bin.js ...

빠른 확인

날짜가 있는 요청은 Asia/Seoul 기준 YYYYMMDD 로 정규화하고 --playDate <YYYYMMDD> 를 항상 붙인다. 예를 들어 오늘을 물으면 KST 오늘 날짜를 계산해서 넣는다.

npx --yes daiso health
npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json
npx --yes daiso get /api/cgv/movies --keyword 강남 --playDate <YYYYMMDD> --json
npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
npx --yes daiso get /api/megabox/theaters --keyword 코엑스 --limit 5 --json
npx --yes daiso get /api/megabox/movies --keyword 코엑스 --playDate <YYYYMMDD> --json
npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
npx --yes daiso get /api/lottecinema/theaters --keyword 월드타워 --limit 5 --json
npx --yes daiso get /api/lottecinema/movies --keyword 월드타워 --playDate <YYYYMMDD> --json
npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json

원본 저장소 clone fallback

git clone https://github.com/hmmhmmhm/daiso-mcp.git
cd daiso-mcp
npm install
npm run build
node dist/bin.js health
node dist/bin.js get /api/cgv/theaters --keyword 강남 --limit 5 --json
node dist/bin.js get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
node dist/bin.js get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
node dist/bin.js get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json

입력값

체인: CGV, 메가박스, 롯데시네마
지역 또는 지점: 강남, 코엑스, 월드타워 등
영화명: 잔여석이나 시간표를 특정 영화로 좁힐 때 사용
날짜: 사용자가 날짜를 말하면 그 날짜를 우선하고, 없으면 Asia/Seoul 기준 오늘을 YYYYMMDD 로 계산한다.

체인	후보 조회	상영작	시간표 또는 잔여석	날짜
CGV	`keyword`, 선택 `limit`	`keyword` 또는 `theaterId`, `playDate`	`keyword` 또는 `theaterId`, `movieId`, `playDate`	필수로 명시
메가박스	`keyword`, 선택 `limit`	`keyword` 또는 `theaterId`, `playDate`	`keyword` 또는 `theaterId`, `movieId`, `playDate`	필수로 명시
롯데시네마	`keyword`, 선택 `limit`	`keyword` 또는 `theaterId`, `playDate`	`keyword` 또는 `theaterId`, `movieId`, `playDate`	필수로 명시

사용 흐름

npx --yes daiso health 로 endpoint 상태를 확인한다.
/api/cgv/theaters, /api/megabox/theaters, /api/lottecinema/theaters 로 영화관 후보를 찾는다.
날짜 표현은 Asia/Seoul 기준 YYYYMMDD 로 바꾼다.
/api/cgv/movies, /api/megabox/movies, /api/lottecinema/movies 로 상영작을 확인한다.
CGV는 /api/cgv/timetable 로 시간표를 본다.
메가박스와 롯데시네마는 /api/megabox/seats, /api/lottecinema/seats 로 잔여석을 본다.
예매와 결제는 자동화하지 않는다.

CGV endpoint가 503 CGV_UPSTREAM_UNAVAILABLE을 반환하면 CGV 공식 웹사이트 (https://www.cgv.co.kr)를 브라우저 사용 스킬로 대체 조회한다. 공식 웹사이트에서도 비정상 접속 차단, CAPTCHA, 브라우저 검증 또는 유사한 접근 제한이 표시되면 우회하지 않고 CGV 조회를 중단한다. 이 fallback은 공개 상영정보 조회에만 사용하며 로그인·예매·결제는 진행하지 않는다.

응답 원칙

기준 체인과 지점을 먼저 쓴다.
상영작과 시간표는 필요한 만큼만 보여준다.
잔여석은 조회 시점의 참고값으로 말한다.
영화관 공식 앱이나 웹에서 예매 직전 다시 확인하라고 안내한다.

실패 모드

CGV 공개 endpoint가 CGV 원본 서비스의 봇 차단·접속 제한을 받으면 503 CGV_UPSTREAM_UNAVAILABLE을 반환할 수 있다. 이 응답은 skill 또는 CLI 입력 오류가 아니라 upstream 접근 실패이므로 CGV 공식 웹사이트를 브라우저 사용 스킬로 대체 조회한다. 공식 웹사이트에서도 차단, CAPTCHA, 브라우저 검증 또는 유사한 접근 제한이 표시되면 우회하지 말고 중단한다.
넓은 지역 키워드는 여러 지점을 섞을 수 있다.
시간표와 잔여석은 빠르게 바뀔 수 있다.
theaterId, movieId가 있으면 keyword보다 그 값을 우선한다.

출처

원본 repo: https://github.com/hmmhmmhm/daiso-mcp
npm package: https://www.npmjs.com/package/daiso
CGV theaters API: https://mcp.aka.page/api/cgv/theaters
CGV movies API: https://mcp.aka.page/api/cgv/movies
CGV timetable API: https://mcp.aka.page/api/cgv/timetable
Megabox theaters API: https://mcp.aka.page/api/megabox/theaters
Megabox movies API: https://mcp.aka.page/api/megabox/movies
Megabox seats API: https://mcp.aka.page/api/megabox/seats
Lotte Cinema theaters API: https://mcp.aka.page/api/lottecinema/theaters
Lotte Cinema movies API: https://mcp.aka.page/api/lottecinema/movies
Lotte Cinema seats API: https://mcp.aka.page/api/lottecinema/seats

5.7 KiB Raw Permalink Blame History