korean-cinema-search

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> 로 넘긴다.

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만 유지한다.