korean-cinema-search

name	korean-cinema-search
description	CGV, 메가박스, 롯데시네마 영화관 검색, 상영작, 시간표, 잔여석 조회가 필요할 때 사용한다.
license	MIT
metadata	{"category":"entertainment","locale":"ko-KR","phase":"v1"}

Korean Cinema Search

What this skill does

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

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

핵심 조회 경로:

• CGV: /api/cgv/theaters, /api/cgv/movies, /api/cgv/timetable
• 메가박스: /api/megabox/theaters, /api/megabox/movies, /api/megabox/seats
• 롯데시네마: /api/lottecinema/theaters, /api/lottecinema/movies, /api/lottecinema/seats
• health check: npx --yes daiso health

When to use

• "강남 근처 CGV 찾아줘"
• "오늘 메가박스 코엑스 상영작 알려줘"
• "롯데시네마 월드타워 잔여석 확인해줘"
• "주변 영화관 시간표 비교해줘"

When not to use

• 예매, 결제, 좌석 선점, 로그인 자동화
• 영화관 계정이나 멤버십 권한이 필요한 기능
• upstream 서버 코드를 이 저장소에 복사해서 유지하려는 경우

Prerequisites

• 인터넷 연결
• node 20 권장
• npx 또는 npm
• 필요하면 git

Preferred setup: CLI first

먼저 MCP 연결이 아니라 upstream CLI로 공개 endpoint를 확인한다.

날짜가 있는 요청은 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

반복 사용이면 전역 설치도 가능하다.

npm install -g daiso
export NODE_PATH="$(npm root -g)"
daiso health

Fallback: clone the original repository

public endpoint 재시도나 버전 고정이 필요하면 원본 저장소를 clone 해서 build 결과물 dist/bin.js 를 직접 실행한다.

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

Required inputs

1. Cinema chain

체인이 없으면 먼저 묻는다.

• 권장 질문: 어느 영화관을 볼까요? CGV, 메가박스, 롯데시네마 중 하나를 알려주세요.

2. Theater or area keyword

지역이나 지점명이 없으면 바로 조회하지 말고 기준 위치를 받는다.

• 권장 질문: 어느 지역이나 지점을 기준으로 볼까요? 예: 강남, 코엑스, 월드타워

3. Movie title when seats are requested

잔여석 질문인데 영화명이 없으면 먼저 영화 후보를 조회하거나 영화명을 물어본다.

4. Date

사용자가 날짜를 말하면 그 날짜를 우선한다. 날짜가 없으면 Asia/Seoul 기준 오늘을 YYYYMMDD 로 계산해 --playDate <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	필수로 명시

Workflow

1. Check server health

npx --yes daiso health

2. Resolve theater candidates

npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json

후보가 여러 개면 상위 2개에서 3개만 요약하고 다시 확인받는다.

3. Resolve movie candidates

npx --yes daiso get /api/cgv/movies --keyword 강남 --playDate <YYYYMMDD> --json

영화 후보가 많으면 제목과 등급만 짧게 정리한다.

4. Check timetable or seats

CGV는 시간표 중심으로 본다.

npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json

메가박스와 롯데시네마는 잔여석 endpoint를 사용할 수 있다.

npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json

5. Respond conservatively

최종 응답은 짧게 정리한다.

• 영화관 체인
• 기준 지역이나 지점
• 상영작 또는 선택 영화
• 시간표와 잔여석
• 조회 시각과 공개 endpoint 특성상 변동 가능하다는 점

예매와 결제는 자동화하지 않는다.

Done when

• hmmhmmhm/daiso-mcp 원본 repo와 daiso CLI 사용 경로를 명시했다.
• MCP 서버를 직접 설치하는 대신 CLI first 흐름을 제시했다.
• CGV, 메가박스, 롯데시네마 조회 범위를 구분했다.
• 영화관 검색, 상영작, 시간표, 잔여석 중 필요한 호출을 실제로 안내했다.
• 예매와 결제 자동화가 범위 밖임을 명시했다.

Failure modes

• public endpoint는 upstream 상태에 따라 간헐적인 5xx를 줄 수 있다.
• 지역 키워드가 넓으면 다른 지점이 섞일 수 있다.
• 시간표와 잔여석은 시점에 따라 달라진다.
• 일부 체인은 상영작, 시간표, 잔여석 endpoint의 입력값이 다르므로 theaterId, movieId가 있으면 그 값을 우선 사용한다.

Notes

• 원본 프로젝트: https://github.com/hmmhmmhm/daiso-mcp
• npm package: https://www.npmjs.com/package/daiso
• 이 저장소는 upstream 코드를 vendoring 하지 않고 skill/docs만 유지한다.