daiso 1.2.7 → 1.2.9

package/dist/api/routes/megaboxRoutes.js

@@ -7,16 +7,16 @@ export function registerMegaboxRoutes(app) {
     app.get('/api/megabox/theaters', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 60 * 24,
         staleWhileRevalidateSeconds: 60 * 5,
-        keyPrefix: 'megabox-theaters-v1',
+        keyPrefix: 'megabox-theaters-v2',
     }, () => handleMegaboxFindNearbyTheaters(c)));
     app.get('/api/megabox/movies', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 10,
         staleWhileRevalidateSeconds: 60,
-        keyPrefix: 'megabox-movies-v1',
+        keyPrefix: 'megabox-movies-v2',
     }, () => handleMegaboxListNowShowing(c)));
     app.get('/api/megabox/seats', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 3,
         staleWhileRevalidateSeconds: 30,
-        keyPrefix: 'megabox-seats-v1',
+        keyPrefix: 'megabox-seats-v2',
     }, () => handleMegaboxGetRemainingSeats(c)));
 }

package/dist/api/routes/opinetRoutes.js

@@ -4,21 +4,21 @@ export function registerOpinetRoutes(app) {
     app.get('/api/opinet/average', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 60,
         staleWhileRevalidateSeconds: 60 * 30,
-        keyPrefix: 'opinet-average-v1',
+        keyPrefix: 'opinet-average-v2',
     }, () => handleOpinetAveragePrices(c)));
     app.get('/api/opinet/lowest', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 30,
         staleWhileRevalidateSeconds: 60 * 10,
-        keyPrefix: 'opinet-lowest-v1',
+        keyPrefix: 'opinet-lowest-v2',
     }, () => handleOpinetLowestStations(c)));
     app.get('/api/opinet/stations/around', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 20,
         staleWhileRevalidateSeconds: 60 * 5,
-        keyPrefix: 'opinet-around-v1',
+        keyPrefix: 'opinet-around-v2',
     }, () => handleOpinetStationsAround(c)));
     app.get('/api/opinet/station', async (c) => withEdgeCache(c.req.url, {
         ttlSeconds: 60 * 60,
         staleWhileRevalidateSeconds: 60 * 10,
-        keyPrefix: 'opinet-station-v1',
+        keyPrefix: 'opinet-station-v2',
     }, () => handleOpinetStationDetail(c)));
 }

package/dist/cli.js

@@ -12,7 +12,7 @@ import { DEFAULT_BASE_URL, DEFAULT_MCP_URL } from './cli/constants.js';
 import { parseCliArgs } from './cli/args.js';
 import { validateCommandOptions } from './cli/commandOptions.js';
 import { handleGet, handleProducts, handleProduct, handleStores, handleInventory, handleDisplayLocation, } from './cli/commands/daiso.js';
-import { handleCuStores, handleCuInventory, handleEmart24Stores, handleEmart24Products, handleEmart24Inventory, handleLotteMartStores, handleLotteMartProducts, handleCompareProducts, handlePlaces, handleGs25Stores, handleGs25Products, handleGs25Inventory, handleSevenElevenProducts, handleSevenElevenStores, handleSevenElevenInventory, handleSevenElevenPopwords, handleSevenElevenCatalog, } from './cli/commands/convenience.js';
+import { handleCuStores, handleCuInventory, handleEmart24Stores, handleEmart24Products, handleEmart24Inventory, handleCompareProducts, handlePlaces, handleGs25Stores, handleGs25Products, handleGs25Inventory, handleSevenElevenProducts, handleSevenElevenStores, handleSevenElevenInventory, handleSevenElevenPopwords, handleSevenElevenCatalog, } from './cli/commands/convenience.js';
 import { handleCgvTheaters, handleCgvMovies, handleCgvTimetable, handleLottecinemaTheaters, handleLottecinemaMovies, handleLottecinemaSeats, handleMegaboxTheaters, handleMegaboxMovies, handleMegaboxSeats, } from './cli/commands/cinema.js';
 function rejectTopLevelUnknownOptions(options, command, deps) {
     const parsed = parseCliArgs(options);
@@ -101,6 +101,10 @@ export async function runCli(argv, deps) {
         resolvedDeps.writeOut(`claude ${cliArgs.join(' ')}`);
         return 0;
     }
+    if (command === 'lottemart-stores' || command === 'lottemart-products') {
+        resolvedDeps.writeErr('롯데마트 서비스 지원이 종료되었습니다.');
+        return 1;
+    }
     if (command === 'get')
         return await handleGet(options, resolvedDeps);
     if (command === 'products')
@@ -145,10 +149,6 @@ export async function runCli(argv, deps) {
         return await handleEmart24Products(options, resolvedDeps);
     if (command === 'emart24-inventory')
         return await handleEmart24Inventory(options, resolvedDeps);
-    if (command === 'lottemart-stores')
-        return await handleLotteMartStores(options, resolvedDeps);
-    if (command === 'lottemart-products')
-        return await handleLotteMartProducts(options, resolvedDeps);
     if (command === 'gs25-stores')
         return await handleGs25Stores(options, resolvedDeps);
     if (command === 'gs25-products')

package/dist/cliHelp.js

@@ -33,8 +33,6 @@ export function printHelp(writeOut) {
     writeOut('  npx daiso cgv-theaters 강남 --limit 5');
     writeOut('  npx daiso cgv-timetable --playDate 20260307 --theaterCode 0056');
     writeOut('  npx daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5');
-    writeOut('  npx daiso lottemart-stores 잠실 --area 서울 --limit 10');
-    writeOut('  npx daiso lottemart-products 콜라 --storeName 강변점 --area 서울');
     writeOut('  npx daiso emart24-products 두바이 --pageSize 20');
     writeOut('  npx daiso gs25-products 오감자');
     writeOut('  npx daiso gs25-inventory 오감자 --storeKeyword 강남');
@@ -48,7 +46,6 @@ export function printHelp(writeOut) {
     writeOut('  제품명을 먼저 검색해 productId를 확인: npx daiso products 수납박스');
     writeOut('  productId로 재고 확인: npx daiso inventory <productId> --keyword 강남역');
     writeOut('  매장을 먼저 검색해 storeName 또는 storeCode를 확인: npx daiso stores 강남역');
-    writeOut('  롯데마트 매장 확인: npx daiso lottemart-stores 잠실 --area 서울');
     writeOut('');
     writeOut('상세 도움말:');
     writeOut('  npx daiso help <command>');

package/dist/cliHelpDefinitions.js

@@ -26,8 +26,6 @@ export const COMMAND_LIST = [
     'megabox-theaters',
     'megabox-movies',
     'megabox-seats',
-    'lottemart-stores',
-    'lottemart-products',
     'emart24-stores',
     'emart24-products',
     'emart24-inventory',
@@ -262,23 +260,8 @@ export const COMMAND_DETAIL = {
         '예시: daiso megabox-seats 강남 --playDate 20260310 --movieId 23816',
         '예시: daiso megabox-seats --playDate 20260310 --keyword "코엑스" --movieId 23816',
     ],
-    'lottemart-stores': [
-        '명령: lottemart-stores',
-        '설명: 롯데마트 계열 매장 검색 API를 호출합니다.',
-        '사용법: daiso lottemart-stores [keyword] [--area 값] [--brandVariant 값] [--lat 값] [--lng 값] [--limit N] [--json]',
-        '옵션: --keyword, --area, --brandVariant, --lat, --lng, --limit, --json',
-        '예시: daiso lottemart-stores 잠실 --area 서울',
-        '예시: daiso lottemart-stores --area 경기 --brandVariant lottemart --limit 10',
-    ],
-    'lottemart-products': [
-        '명령: lottemart-products',
-        '설명: 롯데마트 매장 기준 상품 검색 API를 호출합니다.',
-        '사용법: daiso lottemart-products <keyword> [--storeCode 값 | --storeName 값] [--area 값] [--pageLimit N] [--json]',
-        '필수: <keyword>, --storeCode 또는 --storeName',
-        '옵션: --storeCode, --storeName, --area, --pageLimit, --json',
-        '예시: daiso lottemart-products 콜라 --storeName 강변점 --area 서울',
-        '예시: daiso lottemart-products 우유 --storeCode 2301 --pageLimit 2',
-    ],
+    'lottemart-stores': ['롯데마트 서비스 지원이 종료되었습니다.'],
+    'lottemart-products': ['롯데마트 서비스 지원이 종료되었습니다.'],
     'emart24-stores': [
         '명령: emart24-stores',
         '설명: 이마트24 매장 검색 API를 호출합니다.',

package/dist/index.js

@@ -1,3 +1,5 @@
+import { handleLotteMartFindStores } from './api/lottemartHandlers.js';
+import { geocodeBindings } from './utils/geocode.js';
 /**
  * 다중 서비스 MCP 서버
  *
@@ -17,7 +19,6 @@ import { createDtryxService } from './services/dtryx/index.js';
 import { createMegaboxService } from './services/megabox/index.js';
 import { createCgvService } from './services/cgv/index.js';
 import { createLotteCinemaService } from './services/lottecinema/index.js';
-import { createLotteMartService } from './services/lottemart/index.js';
 import { createCuService } from './services/cu/index.js';
 import { createEmart24Service } from './services/emart24/index.js';
 import { createGs25Service } from './services/gs25/index.js';
@@ -50,7 +51,7 @@ const createRegistry = (bindings) => {
     registry.registerAll([
         createDaisoService,
         () => createGs25Service({
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            ...geocodeBindings(bindings),
             zyteApiKey: bindings?.ZYTE_API_KEY,
             apiKey: bindings?.GS25_API_KEY,
         }),
@@ -66,25 +67,21 @@ const createRegistry = (bindings) => {
         }),
         () => createOpinetService({
             apiKey: bindings?.OPINET_API_KEY,
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            ...geocodeBindings(bindings),
         }),
         () => createCuService({
             zyteApiKey: bindings?.ZYTE_API_KEY,
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            ...geocodeBindings(bindings),
         }),
         createEmart24Service,
-        () => createLotteMartService({
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
-            zyteApiKey: bindings?.ZYTE_API_KEY,
-        }),
-        createMegaboxService,
+        () => createMegaboxService(geocodeBindings(bindings)),
         () => createDtryxService(dtryxTransportFromBindings(bindings)),
         () => createLotteCinemaService({
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            ...geocodeBindings(bindings),
         }),
         () => createCgvService({
             zyteApiKey: bindings?.ZYTE_API_KEY,
-            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            ...geocodeBindings(bindings),
         }),
         () => createOliveyoungService({
             relayUrl: bindings?.OY_RELAY_URL,
@@ -303,6 +300,8 @@ app.get('/privacy', (c) => {
 });
 // GET API 엔드포인트 (MCP 미지원 에이전트용)
 app.get('/api/actions/query', async (c) => {
+    if (['lottemartFindStores', 'lottemartSearchProducts'].includes(c.req.query('action') || ''))
+        return handleLotteMartFindStores(c);
     try {
         const targetUrl = buildActionQueryTargetUrl(c.req.url);
         const headers = new Headers(c.req.raw.headers);

package/dist/middleware/dailyRateLimit.js

@@ -9,7 +9,6 @@ const PROTECTED_SERVICES = [
     { prefix: '/api/cgv/', service: 'cgv' },
     { prefix: '/api/cu/', service: 'cu' },
     { prefix: '/api/gs25/', service: 'gs25' },
-    { prefix: '/api/lottemart/', service: 'lottemart' },
 ];
 const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 // Cloudflare가 교차 존 Worker subrequest에 사용하는 공통 client IP

package/dist/pages/openapiFullSpec.js

@@ -4,7 +4,6 @@
 import { OPENAPI_PATHS_DAISO_OLIVEYOUNG } from './openapiSpecPathsDaisoOliveyoung.js';
 import { OPENAPI_PATHS_CU } from './openapiSpecPathsCu.js';
 import { OPENAPI_PATHS_EMART24 } from './openapiSpecPathsEmart24.js';
-import { OPENAPI_PATHS_LOTTEMART } from './openapiSpecPathsLotteMart.js';
 import { OPENAPI_PATHS_MEGABOX } from './openapiSpecPathsMegabox.js';
 import { OPENAPI_PATHS_CGV } from './openapiSpecPathsCgv.js';
 import { OPENAPI_PATHS_LOTTECINEMA } from './openapiSpecPathsLottecinema.js';
@@ -54,7 +53,6 @@ export function generateFullOpenApiSpec(baseUrl) {
             ...OPENAPI_PATHS_DAISO_OLIVEYOUNG,
             ...OPENAPI_PATHS_CU,
             ...OPENAPI_PATHS_EMART24,
-            ...OPENAPI_PATHS_LOTTEMART,
             ...OPENAPI_PATHS_GS25,
             ...OPENAPI_PATHS_SEVENELEVEN,
             ...OPENAPI_PATHS_COMPARE,

package/dist/pages/openapiSpecActionParameters.js

@@ -192,7 +192,7 @@ export const ACTION_QUERY_PARAMETERS = [
         name: 'area',
         in: 'query',
         required: false,
-        description: '롯데마트 지역',
+        description: '지역',
         schema: { type: 'string' },
     },
     {
@@ -220,7 +220,7 @@ export const ACTION_QUERY_PARAMETERS = [
         name: 'brandVariant',
         in: 'query',
         required: false,
-        description: '롯데마트 브랜드 변형',
+        description: '브랜드 변형',
         schema: { type: 'string' },
     },
     {
@@ -255,7 +255,7 @@ export const ACTION_QUERY_PARAMETERS = [
         name: 'pageLimit',
         in: 'query',
         required: false,
-        description: '롯데마트 추가 페이지 수',
+        description: '추가 페이지 수',
         schema: { type: 'integer' },
     },
     {
@@ -304,7 +304,7 @@ export const ACTION_QUERY_PARAMETERS = [
         name: 'storeName',
         in: 'query',
         required: false,
-        description: '매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.',
+        description: '매장명',
         schema: { type: 'string' },
     },
     {

package/dist/pages/openapiSpecComponents.js

@@ -7,7 +7,6 @@ import { OPENAPI_DAISO_OLIVEYOUNG_COMPONENT_SCHEMAS } from './openapiSpecCompone
 import { OPENAPI_EMART24_COMPONENT_SCHEMAS } from './openapiSpecComponentsEmart24.js';
 import { OPENAPI_GS25_COMPONENT_SCHEMAS } from './openapiSpecComponentsGs25.js';
 import { OPENAPI_LOTTECINEMA_COMPONENT_SCHEMAS } from './openapiSpecComponentsLottecinema.js';
-import { OPENAPI_LOTTEMART_COMPONENT_SCHEMAS } from './openapiSpecComponentsLotteMart.js';
 import { OPENAPI_MEGABOX_COMPONENT_SCHEMAS } from './openapiSpecComponentsMegabox.js';
 import { OPENAPI_SEVENELEVEN_COMPONENT_SCHEMAS } from './openapiSpecComponentsSeveneleven.js';
 export const OPENAPI_COMPONENTS = {
@@ -16,7 +15,6 @@ export const OPENAPI_COMPONENTS = {
         ...OPENAPI_MEGABOX_COMPONENT_SCHEMAS,
         ...OPENAPI_CU_COMPONENT_SCHEMAS,
         ...OPENAPI_EMART24_COMPONENT_SCHEMAS,
-        ...OPENAPI_LOTTEMART_COMPONENT_SCHEMAS,
         ...OPENAPI_GS25_COMPONENT_SCHEMAS,
         ...OPENAPI_SEVENELEVEN_COMPONENT_SCHEMAS,
         ...OPENAPI_LOTTECINEMA_COMPONENT_SCHEMAS,

package/dist/pages/openapiSpecPathsMegabox.js

@@ -6,7 +6,7 @@ export const OPENAPI_PATHS_MEGABOX = {
         get: {
             operationId: 'megaboxFindNearbyTheaters',
             summary: '메가박스 주변 지점 조회',
-            description: '좌표 또는 위치 키워드 기준으로 메가박스 지점을 거리순으로 조회합니다. lat/lng가 없으면 keyword를 구글 지오코드로 보강할 수 있습니다.',
+            description: '좌표 또는 위치 키워드 기준으로 메가박스 지점을 거리순으로 조회합니다. lat/lng가 없으면 keyword를 카카오 무료 위치 검색(장소명은 네이버 지역 검색으로 보완)로 보강할 수 있습니다.',
             parameters: [
                 {
                     name: 'keyword',

package/dist/pages/promptReferenceText.js

@@ -54,8 +54,6 @@ export function buildPromptReferenceText(baseUrl) {
 | GS25_STORE_SEARCH_FAILED | GS25 매장 조회 실패 |
 | GS25_PRODUCT_SEARCH_FAILED | GS25 상품 조회 실패 |
 | GS25_INVENTORY_CHECK_FAILED | GS25 재고 조회 실패 |
-| LOTTEMART_STORE_SEARCH_FAILED | 롯데마트 매장 조회 실패 |
-| LOTTEMART_PRODUCT_SEARCH_FAILED | 롯데마트 상품 조회 실패 |
 | SEVENELEVEN_INVENTORY_CHECK_FAILED | 세븐일레븐 재고 조회 실패 |
 | PLACES_SEARCH_FAILED | 주변 장소 검색 실패 |
 | DEVELOPER_REQUEST_SUBMIT_FAILED | 개발자 요청 저장 실패 |
@@ -107,7 +105,6 @@ export function buildPromptReferenceText(baseUrl) {
    - 너무 넓은 축약어로만 매칭된 경우에는 확정 상품처럼 단정하지 말고, 추정 매칭임을 짧게 밝힌 뒤 재고를 안내합니다.
    - 위치/브랜드/상품명은 한 인자에 섞지 말고 가능한 한 분리해서 도구에 전달합니다.
 8. **위치 기반 재고**: lat, lng 파라미터로 가까운 매장 우선 조회
-9. **롯데마트 상품 조회**: /api/lottemart/products는 keyword와 함께 storeCode 또는 storeName이 필요합니다.
 10. **세븐일레븐 재고 조회**: /api/seveneleven/inventory에 keyword + storeKeyword를 함께 주면 매장별 수량을 바로 확인할 수 있습니다.
 11. **이마트24 재고 조회**: /api/emart24/inventory는 pluCd + storeKeyword 조합도 지원하므로, 상품 선택 뒤 매장 코드를 다시 모으지 않아도 됩니다.
 12. **올리브영 재고 해석**: inventory.products[].storeInventory.stores[]가 있으면 그 매장별 stockLabel과 remainQuantity를 우선 사용하고, inStock는 그 주변 매장 기준 결과로 해석합니다.
@@ -128,8 +125,6 @@ MCP 연결 정보: ${baseUrl}/mcp
 - daiso_check_inventory: 재고 확인
 - daiso_get_price_info: 가격 정보 조회
 - daiso_get_display_location: 진열 위치 조회
-- lottemart_find_nearby_stores: 롯데마트 주변 매장 탐색
-- lottemart_search_products: 롯데마트 상품 검색
 - gs25_find_nearby_stores: GS25 주변 매장 탐색
 - gs25_search_products: GS25 상품 검색
 - gs25_check_inventory: GS25 재고 조회

package/dist/pages/promptRetailCinemaText.js

@@ -48,32 +48,6 @@ export function buildPromptRetailCinemaText(baseUrl) {
 
 ---
 
-### 6-2. 롯데마트 매장/상품 조회
-
-**설명**: 롯데마트 계열 매장 검색과 특정 매장 기준 상품 가격/재고 조회를 제공합니다.
-
-**URL**:
-- ${baseUrl}/api/lottemart/stores?keyword={키워드}
-- ${baseUrl}/api/lottemart/products?keyword={검색어}&storeName={매장명}
-
-**선택 파라미터**:
-- area: 지역 (예: 서울, 경기, 제주)
-- brandVariant: lottemart, toysrus, max, bottlebunker, mealguru, grandgrocery
-- lat: 위도 (선택)
-- lng: 경도 (선택)
-- limit: 최대 결과 수 (기본값: 20)
-- storeCode 또는 storeName: 상품 검색 대상 매장
-- pageLimit: 추가 조회할 최대 페이지 수 (기본값: 3)
-- source: 상품 검색 경로 (auto, legacy, zetta). 빠른 검색이나 헬스체크에는 zetta 권장
-
-**예시**:
-- ${baseUrl}/api/lottemart/stores?keyword=잠실&area=서울&limit=10
-- ${baseUrl}/api/lottemart/stores?area=경기&brandVariant=lottemart&limit=10
-- ${baseUrl}/api/lottemart/products?keyword=콜라&storeName=강변점&area=서울
-- ${baseUrl}/api/lottemart/products?keyword=우유&storeCode=2301&pageLimit=2&source=zetta
-
----
-
 ### 6-3. GS25 매장/상품/재고 조회
 
 **설명**: GS25 매장 탐색, 상품 키워드 검색, 재고 조회를 제공합니다.

package/dist/services/cgv/index.js

@@ -1,6 +1,3 @@
-/**
- * CGV 서비스 프로바이더
- */
 import { createFindTheatersTool } from './tools/findTheaters.js';
 import { createSearchMoviesTool } from './tools/searchMovies.js';
 import { createGetTimetableTool } from './tools/getTimetable.js';
@@ -18,9 +15,9 @@ class CgvService {
     metadata = CGV_METADATA;
     getTools() {
         return [
-            createFindTheatersTool(this.options.zyteApiKey, this.options.googleMapsApiKey),
-            createSearchMoviesTool(this.options.zyteApiKey, this.options.googleMapsApiKey),
-            createGetTimetableTool(this.options.zyteApiKey, this.options.googleMapsApiKey),
+            createFindTheatersTool(this.options.zyteApiKey, this.options.googleMapsApiKey, this.options),
+            createSearchMoviesTool(this.options.zyteApiKey, this.options.googleMapsApiKey, this.options),
+            createGetTimetableTool(this.options.zyteApiKey, this.options.googleMapsApiKey, this.options),
         ];
     }
 }

package/dist/services/cgv/location.js

@@ -1,32 +1,11 @@
 /**
  * CGV 위치 해석 및 근처 극장 조회 보조 모듈
  */
-import { fetchJson } from '../../utils/http.js';
+import { geocodeLocation, readGeocodeEnvironment, searchKakaoPlaces, validKoreanCoordinates, } from '../../utils/geocode.js';
 import { fetchCgvTheaters } from './client.js';
 const DEFAULT_TIMEOUT_MS = 15000;
-const USER_GEOCODE_CACHE_TTL_MS = 60 * 60 * 1000;
-const THEATER_GEOCODE_CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
-const MAX_CANDIDATE_THEATERS = 12;
-const LOCATION_STOPWORDS = new Set([
-    'cgv',
-    '극장',
-    '영화',
-    '주변',
-    '근처',
-    '오늘',
-    '상영',
-    '시간표',
-    '좌석',
-    '잔여',
-    '찾아',
-    '주세요',
-    '주세요요',
-    '역',
-]);
 const BRAND_PATTERN = /\b(?:cgv|씨지브이)\b/giu;
 const TRAILING_INTENT_PATTERN = /\s+(?:극장|영화관|영화|상영작|시간표|좌석|잔여좌석|남은좌석|목록|찾고|찾아|찾아서|알려|보여|추천|조회|확인|해주세요|해줘).*/u;
-const userGeocodeCache = new Map();
-const theaterGeocodeCache = new Map();
 function calculateDistanceKm(lat1, lng1, lat2, lng2) {
     const toRad = (deg) => (deg * Math.PI) / 180;
     const dLat = toRad(lat2 - lat1);
@@ -60,61 +39,12 @@ function sanitizeLocationKeyword(keyword) {
     }
     return sanitized || trimmed;
 }
-function extractLocationTokens(...values) {
-    const tokens = new Set();
-    for (const value of values) {
-        const matches = (value || '').match(/[0-9A-Za-z가-힣]+/g) || [];
-        for (const match of matches) {
-            const normalized = normalizeText(match);
-            if (normalized.length < 2 || LOCATION_STOPWORDS.has(normalized)) {
-                continue;
-            }
-            tokens.add(normalized);
-        }
-    }
-    return [...tokens];
-}
-function scoreTheaterName(theaterName, tokens) {
-    const normalized = normalizeText(theaterName);
-    return tokens.reduce((score, token) => (normalized.includes(token) ? score + 1 : score), 0);
-}
-async function geocodeAddress(query, options, cacheKey, ttlMs, cache) {
-    const apiKey = (options.googleMapsApiKey || '').trim();
-    const trimmedQuery = query.trim();
-    if (apiKey.length === 0 || trimmedQuery.length === 0) {
-        return null;
-    }
-    const cached = cache.get(cacheKey);
-    if (cached && cached.expiresAt > Date.now()) {
-        return cached.value;
-    }
-    const endpoint = new URL('https://maps.googleapis.com/maps/api/geocode/json');
-    endpoint.searchParams.set('address', trimmedQuery);
-    endpoint.searchParams.set('key', apiKey);
-    const body = await fetchJson(endpoint.toString(), {
-        method: 'GET',
-        timeout: options.timeout || DEFAULT_TIMEOUT_MS,
-        headers: { Accept: 'application/json' },
-    });
-    const firstResult = body.status === 'OK' ? body.results?.[0] : null;
-    const latitude = firstResult?.geometry?.location?.lat;
-    const longitude = firstResult?.geometry?.location?.lng;
-    const value = typeof latitude === 'number' && typeof longitude === 'number'
-        ? {
-            latitude,
-            longitude,
-            formattedAddress: firstResult?.formatted_address || null,
-        }
-        : null;
-    cache.set(cacheKey, {
-        expiresAt: Date.now() + ttlMs,
-        value,
-    });
-    return value;
-}
 export async function resolveCgvLocation(params, options = {}) {
     const keyword = sanitizeLocationKeyword((params.keyword || '').trim());
     const hasCoordinates = isValidCoordinate(params.latitude) && isValidCoordinate(params.longitude);
+    if (hasCoordinates &&
+        !validKoreanCoordinates(params.latitude, params.longitude))
+        throw new Error('유효한 위도/경도를 입력해주세요.');
     if (hasCoordinates) {
         return {
             keyword: keyword.length > 0 ? keyword : null,
@@ -133,7 +63,7 @@ export async function resolveCgvLocation(params, options = {}) {
             formattedAddress: null,
         };
     }
-    const geocoded = await geocodeAddress(keyword, options, `user:${keyword}`, USER_GEOCODE_CACHE_TTL_MS, userGeocodeCache);
+    const geocoded = await geocodeLocation(keyword, options);
     return {
         keyword,
         latitude: geocoded?.latitude ?? null,
@@ -142,28 +72,6 @@ export async function resolveCgvLocation(params, options = {}) {
         formattedAddress: geocoded?.formattedAddress ?? null,
     };
 }
-async function geocodeCgvTheater(theater, options) {
-    const cleanName = theater.theaterName.replace(/^CGV\s*/i, '').trim();
-    const geocoded = await geocodeAddress(`대한민국 CGV ${cleanName}`, options, `theater:${theater.theaterCode}:${cleanName}`, THEATER_GEOCODE_CACHE_TTL_MS, theaterGeocodeCache);
-    return geocoded
-        ? {
-            latitude: geocoded.latitude,
-            longitude: geocoded.longitude,
-            address: geocoded.formattedAddress,
-        }
-        : null;
-}
-function pickCandidateTheaters(theaters, tokens) {
-    if (tokens.length === 0) {
-        return theaters.slice(0, MAX_CANDIDATE_THEATERS);
-    }
-    const scored = theaters
-        .map((theater) => ({ theater, score: scoreTheaterName(theater.theaterName, tokens) }))
-        .filter((item) => item.score > 0)
-        .sort((left, right) => right.score - left.score || left.theater.theaterName.localeCompare(right.theater.theaterName))
-        .map((item) => item.theater);
-    return scored.slice(0, MAX_CANDIDATE_THEATERS);
-}
 export async function fetchCgvNearbyTheaters(params, options = {}) {
     const limit = Math.max(1, params.limit || 10);
     const timeout = params.timeout || DEFAULT_TIMEOUT_MS;
@@ -174,34 +82,40 @@ export async function fetchCgvNearbyTheaters(params, options = {}) {
         zyteApiKey: options.zyteApiKey,
     });
     const location = await resolveCgvLocation(params, options);
-    const tokens = extractLocationTokens(location.keyword, location.formattedAddress);
-    const hasGoogleKey = (options.googleMapsApiKey || '').trim().length > 0;
-    if (tokens.length === 0 && !hasGoogleKey) {
-        return {
-            ...location,
-            playDate: params.playDate,
-            regionCode: params.regionCode || null,
-            count: 0,
-            theaters: [],
-        };
+    if (location.keyword && location.latitude === null)
+        throw new Error(`위치를 좌표로 변환하지 못했습니다: ${location.keyword}`);
+    const geocodeOptions = { ...readGeocodeEnvironment(), ...options };
+    let resolvedCandidates;
+    if (location.latitude !== null && location.longitude !== null) {
+        // 주변 장소를 공식 CGV 목록에 연결하여 전국 앞부분만 검색하는 오류를 막습니다.
+        const places = await searchKakaoPlaces('CGV', geocodeOptions, {
+            latitude: location.latitude,
+            longitude: location.longitude,
+        });
+        resolvedCandidates = places.flatMap((place) => {
+            const cleanName = normalizeText((place.place_name || '').replace(/^CGV\s*/iu, ''));
+            const theater = theaters.find((item) => normalizeText(item.theaterName.replace(/^CGV\s*/iu, '')) === cleanName);
+            const latitude = Number(place.y);
+            const longitude = Number(place.x);
+            if (!theater || !validKoreanCoordinates(latitude, longitude))
+                return [];
+            return [
+                {
+                    ...theater,
+                    latitude,
+                    longitude,
+                    address: place.road_address_name || place.address_name || null,
+                    distanceKm: Number(calculateDistanceKm(location.latitude, location.longitude, latitude, longitude).toFixed(2)),
+                },
+            ];
+        });
+    }
+    else {
+        resolvedCandidates = [];
     }
-    const candidates = pickCandidateTheaters(theaters, tokens);
-    const resolvedCandidates = await Promise.all(candidates.map(async (theater) => {
-        const geocoded = await geocodeCgvTheater(theater, options);
-        const distanceKm = geocoded && location.latitude !== null && location.longitude !== null
-            ? Number(calculateDistanceKm(location.latitude, location.longitude, geocoded.latitude, geocoded.longitude).toFixed(2))
-            : null;
-        return {
-            ...theater,
-            latitude: geocoded?.latitude ?? null,
-            longitude: geocoded?.longitude ?? null,
-            distanceKm,
-            address: geocoded?.address ?? null,
-        };
-    }));
     const sorted = resolvedCandidates.sort((left, right) => {
-        const leftDistance = left.distanceKm ?? Number.POSITIVE_INFINITY;
-        const rightDistance = right.distanceKm ?? Number.POSITIVE_INFINITY;
+        const leftDistance = left.distanceKm;
+        const rightDistance = right.distanceKm;
         return leftDistance - rightDistance || left.theaterName.localeCompare(right.theaterName);
     });
     return {
@@ -230,6 +144,5 @@ export async function resolveCgvNearestTheater(params, options = {}) {
     };
 }
 export function __testOnlyClearCgvLocationCaches() {
-    userGeocodeCache.clear();
-    theaterGeocodeCache.clear();
+    // 캐시를 유지하지 않으므로 초기화할 상태가 없습니다.
 }

package/dist/services/cgv/tools/findTheaters.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { fetchCgvTheaters, toYyyymmdd } from '../client.js';
 import { fetchCgvNearbyTheaters } from '../location.js';
-async function findTheaters(args, apiKey, googleMapsApiKey) {
+async function findTheaters(args, apiKey, googleMapsApiKey, geocodeOptions = {}) {
     const { playDate = toYyyymmdd(), regionCode, keyword, latitude, longitude, limit = 30, timeoutMs = 15000, } = args;
     if (keyword || typeof latitude === 'number' || typeof longitude === 'number') {
         const result = await fetchCgvNearbyTheaters({
@@ -18,7 +18,8 @@ async function findTheaters(args, apiKey, googleMapsApiKey) {
         }, {
             timeout: timeoutMs,
             zyteApiKey: apiKey,
-            googleMapsApiKey: googleMapsApiKey || process.env.GOOGLE_MAPS_API_KEY,
+            ...geocodeOptions,
+            googleMapsApiKey,
         });
         return {
             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
@@ -47,7 +48,7 @@ async function findTheaters(args, apiKey, googleMapsApiKey) {
         content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
 }
-export function createFindTheatersTool(apiKey, googleMapsApiKey) {
+export function createFindTheatersTool(apiKey, googleMapsApiKey, geocodeOptions = {}) {
     return {
         name: 'cgv_find_theaters',
         metadata: {
@@ -63,6 +64,6 @@ export function createFindTheatersTool(apiKey, googleMapsApiKey) {
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: ((args) => findTheaters(args, apiKey, googleMapsApiKey)),
+        handler: ((args) => findTheaters(args, apiKey, googleMapsApiKey, geocodeOptions)),
     };
 }

package/dist/services/cgv/tools/getTimetable.js

@@ -5,7 +5,7 @@ import * as z from 'zod';
 import { fetchCgvTimetable, toYyyymmdd } from '../client.js';
 import { resolveCgvNearestTheater } from '../location.js';
 import { filterAndSortTimetable } from '../timetable.js';
-async function getTimetable(args, apiKey, googleMapsApiKey) {
+async function getTimetable(args, apiKey, googleMapsApiKey, geocodeOptions = {}) {
     const { playDate = toYyyymmdd(), theaterCode, movieCode, keyword, latitude, longitude, limit = 50, timeoutMs = 15000, } = args;
     let resolvedTheater = null;
     let targetTheaterCode = theaterCode;
@@ -19,7 +19,8 @@ async function getTimetable(args, apiKey, googleMapsApiKey) {
         }, {
             timeout: timeoutMs,
             zyteApiKey: apiKey,
-            googleMapsApiKey: googleMapsApiKey || process.env.GOOGLE_MAPS_API_KEY,
+            ...geocodeOptions,
+            googleMapsApiKey,
         });
         resolvedTheater = resolved.theater;
         targetTheaterCode = resolved.theater?.theaterCode;
@@ -53,7 +54,7 @@ async function getTimetable(args, apiKey, googleMapsApiKey) {
         content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
 }
-export function createGetTimetableTool(apiKey, googleMapsApiKey) {
+export function createGetTimetableTool(apiKey, googleMapsApiKey, geocodeOptions = {}) {
     return {
         name: 'cgv_get_timetable',
         metadata: {
@@ -70,6 +71,6 @@ export function createGetTimetableTool(apiKey, googleMapsApiKey) {
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: ((args) => getTimetable(args, apiKey, googleMapsApiKey)),
+        handler: ((args) => getTimetable(args, apiKey, googleMapsApiKey, geocodeOptions)),
     };
 }