korean-cinema-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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
```

基于上游原项目

hmmhmmhm/daiso-mcp

及npm包

daiso

，提供CGV、Megabox、Lotte Cinema影院搜索、上映影片查询、排片时间表查看及剩余座位查询的指引。

本仓库不会对上游代码进行vendoring（代码内置）。默认流程为无需安装MCP服务器，优先通过CLI进行验证的方式。

核心查询路径：

CGV:

/api/cgv/theaters

/api/cgv/movies

/api/cgv/timetable

Megabox:

/api/megabox/theaters

/api/megabox/movies

/api/megabox/seats

Lotte Cinema:

/api/lottecinema/theaters

/api/lottecinema/movies

/api/lottecinema/seats

健康检查:
```
npx --yes daiso health
```

When to use

使用场景

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

"帮我查找江南附近的CGV影院"
"告诉我今天Megabox Coex的上映影片"
"帮我查看Lotte Cinema World Tower的剩余座位"
"帮我对比周边影院的排片时间表"

When not to use

不适用场景

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

购票、支付、座位预留、登录自动化
需要影院账户或会员权限的功能
想要将上游服务器代码复制到本仓库进行维护的情况

Prerequisites

前置条件

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

网络连接
推荐使用
```
node
```
20版本
安装有
```
npx
```
或
```
npm
```
必要时需安装
```
git
```

Preferred setup: CLI first

推荐配置：优先使用CLI

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

날짜가 있는 요청은 Asia/Seoul 기준

YYYYMMDD

로 정규화하고

--playDate <YYYYMMDD>

를 항상 붙인다. 사용자가 오늘이라고 말하거나 날짜를 생략하면 KST 오늘 날짜를 계산한다.

bash

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

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

bash

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

首先无需连接MCP，直接通过上游CLI验证公开接口。

带有日期的请求需按照Asia/Seoul时区规范为

YYYYMMDD

格式，并始终添加

--playDate <YYYYMMDD>

参数。若用户提及“今天”或未指定日期，则自动计算KST时区下的当日日期。

bash

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

若需重复使用，也可进行全局安装。

bash

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

Fallback: clone the original repository

备选方案：克隆原仓库

public endpoint 재시도나 버전 고정이 필요하면 원본 저장소를 clone 해서 build 결과물

dist/bin.js

를 직접 실행한다.

bash

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

若需重试公开接口或固定版本，可克隆原仓库并直接运行构建产物

dist/bin.js

。

bash

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

1. 影院品牌

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

권장 질문:

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

若未指定影院品牌，需先询问用户。

推荐提问：

请问您要查询哪个影院？请从CGV、Megabox、Lotte Cinema中选择一个。

2. Theater or area keyword

2. 影院或区域关键词

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

권장 질문:

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

若未指定区域或影院分店名称，请勿直接查询，需先获取用户的基准位置。

推荐提问：

请问以哪个区域或分店为基准查询？例如：江南、Coex、World Tower

3. Movie title when seats are requested

3. 查询座位时需提供影片名称

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

若用户查询剩余座位但未提供影片名称，需先查询影片候选列表或询问用户影片名称。

4. Date

4. 日期

사용자가 날짜를 말하면 그 날짜를 우선한다. 날짜가 없으면 Asia/Seoul 기준 오늘을

YYYYMMDD

로 계산해

--playDate <YYYYMMDD>

로 넘긴다.

체인 후보 조회 상영작 시간표 또는 잔여석 날짜

CGV

체인	후보 조회	상영작	시간표 또는 잔여석	날짜
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`	필수로 명시

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

필수로 명시

若用户指定日期，则优先使用该日期。若未指定日期，则按照Asia/Seoul时区计算当日日期，格式为

YYYYMMDD

，并传入

--playDate <YYYYMMDD>

参数。

影院品牌候选查询上映影片时间表或剩余座位日期

CGV

影院品牌	候选查询	上映影片	时间表或剩余座位	日期
CGV	`keyword` ，可选 `limit`	`keyword` 或 `theaterId` 、 `playDate`	`keyword` 或 `theaterId` 、 `movieId` 、 `playDate`	必须指定
Megabox	`keyword` ，可选 `limit`	`keyword` 或 `theaterId` 、 `playDate`	`keyword` 或 `theaterId` 、 `movieId` 、 `playDate`	必须指定
Lotte Cinema	`keyword` ，可选 `limit`	`keyword` 或 `theaterId` 、 `playDate`	`keyword` 或 `theaterId` 、 `movieId` 、 `playDate`	必须指定

keyword

，可选

limit

keyword

或

theaterId

、

playDate

keyword

或

theaterId

、

movieId

、

playDate

必须指定

Megabox

keyword

，可选

limit

keyword

或

theaterId

、

playDate

keyword

或

theaterId

、

movieId

、

playDate

必须指定

Lotte Cinema

keyword

，可选

limit

keyword

或

theaterId

、

playDate

keyword

或

theaterId

、

movieId

、

playDate

必须指定

Workflow

操作流程

1. Check server health

1. 检查服务器健康状态

bash

npx --yes daiso health

bash

npx --yes daiso health

2. Resolve theater candidates

2. 获取影院候选列表

bash

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

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

bash

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

若候选列表有多个结果，仅总结前2-3个并再次向用户确认。

3. Resolve movie candidates

3. 获取影片候选列表

bash

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

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

bash

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

若影片候选列表较多，仅简要整理影片名称和分级信息。

4. Check timetable or seats

4. 查询时间表或剩余座位

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

bash

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

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

bash

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

CGV优先查看排片时间表。

bash

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

Megabox和Lotte Cinema可使用剩余座位查询接口。

bash

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

5. 简洁回复

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

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

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

最终回复需简洁整理以下信息：

影院品牌
基准区域或分店
上映影片或用户选择的影片
排片时间表及剩余座位
提示因查询时间及公开接口特性，信息可能发生变动

不支持购票和支付自动化。

Done when

完成标准

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

已明确
```
hmmhmmhm/daiso-mcp
```
原仓库及
```
daiso
```
CLI的使用流程
已提供优先使用CLI的流程，替代直接安装MCP服务器的方式
已区分CGV、Megabox、Lotte Cinema的查询范围
已实际指引影院搜索、上映影片、时间表、剩余座位的必要调用
已明确购票和支付自动化不属于本工具的功能范围

Failure modes

故障场景

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

公开接口可能因上游服务器状态问题，间歇性返回5xx错误
若区域关键词范围过广，可能混入其他分店的信息
排片时间表和剩余座位信息会随时间变化
部分影院品牌的上映影片、时间表、剩余座位接口输入参数不同，若存在theaterId、movieId则优先使用这些参数

Notes

注意事项

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

原项目：
```
https://github.com/hmmhmmhm/daiso-mcp
```
npm包：
```
https://www.npmjs.com/package/daiso
```
本仓库不内置上游代码，仅维护工具文档