daiso 1.0.4 → 1.0.6

package/dist/pages/openapiSpecActions.js

@@ -0,0 +1,109 @@
+/**
+ * OpenAI Actions용 축약 OpenAPI 스펙
+ */
+import { ACTION_QUERY_ACTIONS } from '../api/actionsProxy.js';
+import { OPENAPI_COMPONENTS } from './openapiSpecComponents.js';
+const ACTION_QUERY_PARAMETERS = [
+    {
+        name: 'action',
+        in: 'query',
+        required: true,
+        description: '실행할 액션 이름입니다. 사용 가능한 값은 enum 목록을 참고하세요.',
+        schema: {
+            type: 'string',
+            enum: ACTION_QUERY_ACTIONS,
+        },
+    },
+    { name: 'q', in: 'query', required: false, description: '다이소 제품 검색어', schema: { type: 'string' } },
+    { name: 'query', in: 'query', required: false, description: '세븐일레븐 상품 검색어', schema: { type: 'string' } },
+    { name: 'itemCode', in: 'query', required: false, description: 'GS25 상품 코드', schema: { type: 'string' } },
+    { name: 'productId', in: 'query', required: false, description: '제품 ID 또는 상세 조회용 path 파라미터. 상품명만 알면 먼저 daisoSearchProducts 또는 /api/daiso/products로 productId를 확인하세요.', schema: { type: 'string' } },
+    { name: 'keyword', in: 'query', required: false, description: '공통 키워드 파라미터', schema: { type: 'string' } },
+    { name: 'sido', in: 'query', required: false, description: '다이소 시/도', schema: { type: 'string' } },
+    { name: 'gugun', in: 'query', required: false, description: '다이소 구/군', schema: { type: 'string' } },
+    { name: 'dong', in: 'query', required: false, description: '다이소 동', schema: { type: 'string' } },
+    { name: 'area', in: 'query', required: false, description: '롯데마트 지역', schema: { type: 'string' } },
+    { name: 'area1', in: 'query', required: false, description: '이마트24 1차 지역', schema: { type: 'string' } },
+    { name: 'area2', in: 'query', required: false, description: '이마트24 2차 지역', schema: { type: 'string' } },
+    { name: 'areaCode', in: 'query', required: false, description: '메가박스 지역 코드', schema: { type: 'string' } },
+    { name: 'brandVariant', in: 'query', required: false, description: '롯데마트 브랜드 변형', schema: { type: 'string' } },
+    { name: 'lat', in: 'query', required: false, description: '위도', schema: { type: 'number', format: 'float' } },
+    { name: 'lng', in: 'query', required: false, description: '경도', schema: { type: 'number', format: 'float' } },
+    { name: 'page', in: 'query', required: false, description: '페이지 번호', schema: { type: 'integer' } },
+    { name: 'pageIdx', in: 'query', required: false, description: '올리브영 페이지 번호', schema: { type: 'integer' } },
+    { name: 'pageLimit', in: 'query', required: false, description: '롯데마트 추가 페이지 수', schema: { type: 'integer' } },
+    { name: 'pageSize', in: 'query', required: false, description: '페이지 크기', schema: { type: 'integer' } },
+    { name: 'size', in: 'query', required: false, description: '페이지 크기 또는 검색 크기', schema: { type: 'integer' } },
+    { name: 'offset', in: 'query', required: false, description: 'CU 검색 오프셋', schema: { type: 'integer' } },
+    { name: 'limit', in: 'query', required: false, description: '최대 결과 수', schema: { type: 'integer' } },
+    { name: 'storeLimit', in: 'query', required: false, description: '매장 결과 제한 수', schema: { type: 'integer' } },
+    { name: 'storeCode', in: 'query', required: false, description: '매장 코드. 다이소 진열 위치는 /api/daiso/inventory 응답의 storeInventory.stores[].storeCode에서 확인하세요.', schema: { type: 'string' } },
+    { name: 'storeName', in: 'query', required: false, description: '매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.', schema: { type: 'string' } },
+    { name: 'storeKeyword', in: 'query', required: false, description: '매장 키워드', schema: { type: 'string' } },
+    { name: 'playDate', in: 'query', required: false, description: '상영일(YYYYMMDD)', schema: { type: 'string' } },
+    { name: 'regionCode', in: 'query', required: false, description: 'CGV 지역 코드', schema: { type: 'string' } },
+    { name: 'theaterCode', in: 'query', required: false, description: 'CGV 극장 코드', schema: { type: 'string' } },
+    { name: 'theaterId', in: 'query', required: false, description: '메가박스/롯데시네마 지점 ID', schema: { type: 'string' } },
+    { name: 'movieCode', in: 'query', required: false, description: 'CGV 영화 코드', schema: { type: 'string' } },
+    { name: 'movieId', in: 'query', required: false, description: '메가박스/롯데시네마 영화 ID', schema: { type: 'string' } },
+    { name: 'pluCd', in: 'query', required: false, description: '이마트24 상품 PLU 코드', schema: { type: 'string' } },
+    { name: 'bizNoArr', in: 'query', required: false, description: '이마트24 사업자번호 목록', schema: { type: 'string' } },
+    { name: 'label', in: 'query', required: false, description: '세븐일레븐 인기 검색어 라벨', schema: { type: 'string' } },
+    { name: 'sort', in: 'query', required: false, description: '정렬 기준', schema: { type: 'string' } },
+    { name: 'searchSort', in: 'query', required: false, description: 'CU 검색 정렬 기준', schema: { type: 'string' } },
+    { name: 'service24h', in: 'query', required: false, description: '이마트24 24시간 필터', schema: { type: 'boolean' } },
+    { name: 'includeSoldOut', in: 'query', required: false, description: '올리브영 품절 포함 여부', schema: { type: 'boolean' } },
+    { name: 'includeIssues', in: 'query', required: false, description: '세븐일레븐 이달의 행사지 포함 여부', schema: { type: 'boolean' } },
+    { name: 'includeExhibition', in: 'query', required: false, description: '세븐일레븐 전시상품 포함 여부', schema: { type: 'boolean' } },
+    { name: 'timeoutMs', in: 'query', required: false, description: '세븐일레븐 inventory 타임아웃', schema: { type: 'integer' } },
+];
+export function generateOpenApiSpec(baseUrl) {
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: '다이소 MCP API (OpenAI Actions용)',
+            description: `OpenAI 챗봇의 OpenAPI import 개수 제한을 피하기 위해 모든 GET API를 단일 facade 엔드포인트로 집약한 스펙입니다.
+
+실제 런타임은 기존 /api/{service}/... 엔드포인트로 위임하며, 이 스펙은 OpenAI Actions 등록 전용으로 사용합니다.
+
+브랜드명이 요청 앞부분에 나오면 뒤의 상품/재고 요청까지 같은 브랜드로 해석해야 합니다. 예: "안산 중앙역 주변 다이소 찾아주시고 핫식스 재고 찾아주세요"는 다이소 기준 조회를 먼저 수행하고, 결과가 없을 때만 다른 브랜드를 제안합니다.
+
+전체 개별 엔드포인트 스펙이 필요하면 /openapi-full.json 또는 /openapi-full.yaml 을 사용하세요.`,
+            version: '1.0.0',
+            contact: {
+                name: 'GitHub Repository',
+                url: 'https://github.com/hmmhmmhm/daiso-mcp',
+            },
+        },
+        servers: [{ url: baseUrl, description: 'Production Server' }],
+        paths: {
+            '/api/actions/query': {
+                get: {
+                    operationId: 'queryAction',
+                    summary: '공통 GET 액션 실행',
+                    description: 'action 값에 따라 기존 GET API 엔드포인트로 프록시합니다. OpenAI Actions 등록 시 이 단일 엔드포인트를 사용하세요.',
+                    parameters: ACTION_QUERY_PARAMETERS,
+                    responses: {
+                        '200': {
+                            description: '프록시 호출 성공',
+                            content: {
+                                'application/json': {
+                                    schema: { $ref: '#/components/schemas/ActionQueryResponse' },
+                                },
+                            },
+                        },
+                        '400': {
+                            description: '잘못된 요청',
+                            content: {
+                                'application/json': {
+                                    schema: { $ref: '#/components/schemas/ErrorResponse' },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        components: OPENAPI_COMPONENTS,
+    };
+}

package/dist/pages/openapiSpecComponents.js

@@ -2,416 +2,55 @@
  * OpenAPI 컴포넌트 스키마 정의
  */
 import { OPENAPI_CGV_COMPONENT_SCHEMAS } from './openapiSpecComponentsCgv.js';
+import { OPENAPI_CU_COMPONENT_SCHEMAS } from './openapiSpecComponentsCu.js';
+import { OPENAPI_DAISO_OLIVEYOUNG_COMPONENT_SCHEMAS } from './openapiSpecComponentsDaisoOliveyoung.js';
+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 = {
     schemas: {
-        Product: {
-            type: 'object',
-            description: '제품 정보',
-            properties: {
-                id: { type: 'string', description: '제품 ID', example: '1234567890' },
-                name: { type: 'string', description: '제품명', example: 'PP 수납박스 대형' },
-                price: { type: 'integer', description: '가격 (원)', example: 5000 },
-                imageUrl: {
-                    type: 'string',
-                    description: '제품 이미지 URL',
-                    example: 'https://img.daisomall.co.kr/...',
-                },
-                soldOut: { type: 'boolean', description: '품절 여부', example: false },
-                isNew: { type: 'boolean', description: '신상품 여부', example: false },
-                pickupAvailable: { type: 'boolean', description: '매장 픽업 가능 여부', example: true },
-            },
-        },
-        ProductDetail: {
-            type: 'object',
-            description: '제품 상세 정보',
-            properties: {
-                id: { type: 'string', description: '제품 ID' },
-                name: { type: 'string', description: '제품명' },
-                price: { type: 'integer', description: '가격 (원)' },
-                currency: { type: 'string', description: '통화', example: 'KRW' },
-                imageUrl: { type: 'string', description: '제품 이미지 URL' },
-                brand: { type: 'string', description: '브랜드명' },
-                soldOut: { type: 'boolean', description: '품절 여부' },
-                isNew: { type: 'boolean', description: '신상품 여부' },
-            },
-        },
-        Store: {
-            type: 'object',
-            description: '매장 정보',
-            properties: {
-                name: { type: 'string', description: '매장명', example: '다이소 강남역점' },
-                phone: { type: 'string', description: '전화번호', example: '02-1234-5678' },
-                address: {
-                    type: 'string',
-                    description: '주소',
-                    example: '서울특별시 강남구 강남대로 123',
-                },
-                lat: { type: 'number', format: 'float', description: '위도', example: 37.4979 },
-                lng: { type: 'number', format: 'float', description: '경도', example: 127.0276 },
-                openTime: { type: 'string', description: '영업 시작 시간', example: '10:00' },
-                closeTime: { type: 'string', description: '영업 종료 시간', example: '22:00' },
-                options: {
-                    type: 'object',
-                    description: '매장 옵션',
-                    properties: {
-                        parking: { type: 'boolean', description: '주차 가능 여부' },
-                        pickup: { type: 'boolean', description: '픽업 가능 여부' },
-                        taxFree: { type: 'boolean', description: '면세 가능 여부' },
-                    },
-                },
-            },
-        },
-        StoreInventory: {
-            type: 'object',
-            description: '매장 재고 정보',
-            properties: {
-                storeCode: { type: 'string', description: '매장 코드', example: 'ST001' },
-                storeName: { type: 'string', description: '매장명', example: '다이소 강남역점' },
-                address: { type: 'string', description: '주소' },
-                distance: { type: 'string', description: '거리', example: '0.5km' },
-                quantity: { type: 'integer', description: '재고 수량', example: 12 },
-                options: {
-                    type: 'object',
-                    properties: {
-                        parking: { type: 'boolean' },
-                        pickup: { type: 'boolean' },
-                    },
-                },
-            },
-        },
-        ProductSearchResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        products: { type: 'array', items: { $ref: '#/components/schemas/Product' } },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer', description: '전체 결과 수' },
-                        page: { type: 'integer', description: '현재 페이지' },
-                        pageSize: { type: 'integer', description: '페이지당 결과 수' },
-                    },
-                },
-            },
-        },
-        ProductDetailResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: { $ref: '#/components/schemas/ProductDetail' },
-            },
-        },
-        StoreSearchResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        stores: { type: 'array', items: { $ref: '#/components/schemas/Store' } },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: { total: { type: 'integer', description: '전체 결과 수' } },
-                },
-            },
-        },
-        InventoryResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        productId: { type: 'string', description: '제품 ID' },
-                        location: {
-                            type: 'object',
-                            properties: {
-                                latitude: { type: 'number', format: 'float' },
-                                longitude: { type: 'number', format: 'float' },
-                            },
-                        },
-                        onlineStock: { type: 'integer', description: '온라인 재고 수량', example: 150 },
-                        storeInventory: {
-                            type: 'object',
-                            properties: {
-                                totalStores: { type: 'integer', description: '전체 매장 수' },
-                                inStockCount: { type: 'integer', description: '재고 있는 매장 수' },
-                                stores: {
-                                    type: 'array',
-                                    items: { $ref: '#/components/schemas/StoreInventory' },
-                                },
-                            },
-                        },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                        page: { type: 'integer' },
-                        pageSize: { type: 'integer' },
-                    },
-                },
-            },
-        },
-        OliveyoungStore: {
-            type: 'object',
-            description: '올리브영 매장 정보',
-            properties: {
-                storeCode: { type: 'string', example: 'D176' },
-                storeName: { type: 'string', example: '올리브영 명동 타운' },
-                address: { type: 'string', example: '서울특별시 중구 명동길 53' },
-                latitude: { type: 'number', format: 'float', example: 37.56409158 },
-                longitude: { type: 'number', format: 'float', example: 126.9851771 },
-                pickupYn: { type: 'boolean', example: false },
-                o2oRemainQuantity: { type: 'integer', example: 0 },
-            },
-        },
-        OliveyoungProduct: {
-            type: 'object',
-            description: '올리브영 상품 재고 정보',
-            properties: {
-                goodsNumber: { type: 'string', example: 'A000000200614' },
-                goodsName: { type: 'string', example: '달바 퍼플 톤업 선크림 듀오 기획' },
-                priceToPay: { type: 'integer', example: 32130 },
-                originalPrice: { type: 'integer', example: 51000 },
-                discountRate: { type: 'integer', example: 37 },
-                o2oStockFlag: { type: 'boolean', example: true },
-                o2oRemainQuantity: { type: 'integer', example: 0 },
-            },
-        },
-        OliveyoungStoreSearchResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        stores: {
-                            type: 'array',
-                            items: { $ref: '#/components/schemas/OliveyoungStore' },
-                        },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                        page: { type: 'integer' },
-                        pageSize: { type: 'integer' },
-                    },
-                },
-            },
-        },
-        OliveyoungInventoryResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        keyword: { type: 'string', example: '선크림' },
-                        location: {
-                            type: 'object',
-                            properties: {
-                                latitude: { type: 'number', format: 'float' },
-                                longitude: { type: 'number', format: 'float' },
-                            },
-                        },
-                        nearbyStores: {
-                            type: 'object',
-                            properties: {
-                                totalCount: { type: 'integer' },
-                                stores: {
-                                    type: 'array',
-                                    items: { $ref: '#/components/schemas/OliveyoungStore' },
-                                },
-                            },
-                        },
-                        inventory: {
-                            type: 'object',
-                            properties: {
-                                totalCount: { type: 'integer' },
-                                nextPage: { type: 'boolean' },
-                                products: {
-                                    type: 'array',
-                                    items: { $ref: '#/components/schemas/OliveyoungProduct' },
-                                },
-                            },
-                        },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                        page: { type: 'integer' },
-                        pageSize: { type: 'integer' },
-                    },
-                },
-            },
-        },
-        MegaboxTheater: {
-            type: 'object',
-            properties: {
-                theaterId: { type: 'string', example: '1372' },
-                theaterName: { type: 'string', example: '강남' },
-                address: { type: 'string', example: '서울특별시 강남구 강남대로 438' },
-                latitude: { type: 'number', format: 'float', example: 37.4982 },
-                longitude: { type: 'number', format: 'float', example: 127.0264 },
-                distanceKm: { type: 'number', format: 'float', example: 0.5 },
-            },
-        },
-        MegaboxShowtime: {
-            type: 'object',
-            properties: {
-                scheduleId: { type: 'string', example: '2603041372011' },
-                movieId: { type: 'string', example: '25104500' },
-                movieName: { type: 'string', example: '미키 17' },
-                theaterId: { type: 'string', example: '1372' },
-                theaterName: { type: 'string', example: '강남' },
-                playDate: { type: 'string', example: '20260304' },
-                startTime: { type: 'string', example: '09:30' },
-                endTime: { type: 'string', example: '11:20' },
-                totalSeats: { type: 'integer', example: 120 },
-                remainingSeats: { type: 'integer', example: 42 },
-            },
-        },
-        MegaboxTheaterSearchResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        location: {
-                            type: 'object',
-                            properties: {
-                                latitude: { type: 'number', format: 'float' },
-                                longitude: { type: 'number', format: 'float' },
-                            },
-                        },
-                        playDate: { type: 'string' },
-                        areaCode: { type: 'string' },
-                        theaters: {
-                            type: 'array',
-                            items: { $ref: '#/components/schemas/MegaboxTheater' },
-                        },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                        pageSize: { type: 'integer' },
-                    },
-                },
-            },
-        },
-        MegaboxMovieListResponse: {
+        ...OPENAPI_DAISO_OLIVEYOUNG_COMPONENT_SCHEMAS,
+        ...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,
+        ...OPENAPI_CGV_COMPONENT_SCHEMAS,
+        ErrorResponse: {
             type: 'object',
             properties: {
-                success: { type: 'boolean', example: true },
-                data: {
+                success: { type: 'boolean', example: false },
+                error: {
                     type: 'object',
                     properties: {
-                        playDate: { type: 'string' },
-                        filters: {
-                            type: 'object',
-                            properties: {
-                                theaterId: { type: 'string', nullable: true },
-                                movieId: { type: 'string', nullable: true },
-                                areaCode: { type: 'string' },
-                            },
-                        },
-                        theaters: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    theaterId: { type: 'string' },
-                                    theaterName: { type: 'string' },
-                                },
-                            },
-                        },
-                        movies: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    movieId: { type: 'string' },
-                                    movieName: { type: 'string' },
-                                    movieStatus: { type: 'string' },
-                                },
-                            },
-                        },
-                        showtimes: {
-                            type: 'array',
-                            items: { $ref: '#/components/schemas/MegaboxShowtime' },
+                        code: { type: 'string', description: '에러 코드', example: 'MISSING_QUERY' },
+                        message: {
+                            type: 'string',
+                            description: '에러 메시지',
+                            example: '검색어(q)를 입력해주세요.',
                         },
                     },
                 },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                    },
-                },
             },
         },
-        MegaboxSeatListResponse: {
+        ActionQueryResponse: {
             type: 'object',
             properties: {
                 success: { type: 'boolean', example: true },
                 data: {
                     type: 'object',
-                    properties: {
-                        playDate: { type: 'string' },
-                        filters: {
-                            type: 'object',
-                            properties: {
-                                theaterId: { type: 'string', nullable: true },
-                                movieId: { type: 'string', nullable: true },
-                                areaCode: { type: 'string' },
-                            },
-                        },
-                        seats: {
-                            type: 'array',
-                            items: { $ref: '#/components/schemas/MegaboxShowtime' },
-                        },
-                    },
+                    additionalProperties: true,
+                    description: '대상 엔드포인트가 반환한 data 객체',
                 },
                 meta: {
                     type: 'object',
-                    properties: {
-                        total: { type: 'integer' },
-                        pageSize: { type: 'integer' },
-                    },
-                },
-            },
-        },
-        ...OPENAPI_CGV_COMPONENT_SCHEMAS,
-        ErrorResponse: {
-            type: 'object',
-            properties: {
-                success: { type: 'boolean', example: false },
-                error: {
-                    type: 'object',
-                    properties: {
-                        code: { type: 'string', description: '에러 코드', example: 'MISSING_QUERY' },
-                        message: {
-                            type: 'string',
-                            description: '에러 메시지',
-                            example: '검색어(q)를 입력해주세요.',
-                        },
-                    },
+                    additionalProperties: true,
+                    description: '대상 엔드포인트가 반환한 meta 객체',
                 },
             },
         },

package/dist/pages/openapiSpecComponentsCgv.js

@@ -8,6 +8,10 @@ export const OPENAPI_CGV_COMPONENT_SCHEMAS = {
             theaterCode: { type: 'string', example: '0056' },
             theaterName: { type: 'string', example: 'CGV강남' },
             regionCode: { type: 'string', example: '01' },
+            latitude: { type: 'number', nullable: true, example: 37.5016 },
+            longitude: { type: 'number', nullable: true, example: 127.0264 },
+            distanceKm: { type: 'number', nullable: true, example: 0.8 },
+            address: { type: 'string', nullable: true, example: '서울특별시 강남구 강남대로 438' },
         },
     },
     CgvMovie: {
@@ -45,8 +49,16 @@ export const OPENAPI_CGV_COMPONENT_SCHEMAS = {
                         type: 'object',
                         properties: {
                             regionCode: { type: 'string', nullable: true },
+                            keyword: { type: 'string', nullable: true },
+                            latitude: { type: 'number', nullable: true },
+                            longitude: { type: 'number', nullable: true },
                         },
                     },
+                    keyword: { type: 'string', nullable: true },
+                    latitude: { type: 'number', nullable: true },
+                    longitude: { type: 'number', nullable: true },
+                    geocodeUsed: { type: 'boolean' },
+                    formattedAddress: { type: 'string', nullable: true },
                     theaters: {
                         type: 'array',
                         items: { $ref: '#/components/schemas/CgvTheater' },
@@ -74,8 +86,14 @@ export const OPENAPI_CGV_COMPONENT_SCHEMAS = {
                         type: 'object',
                         properties: {
                             theaterCode: { type: 'string', nullable: true },
+                            keyword: { type: 'string', nullable: true },
+                            latitude: { type: 'number', nullable: true },
+                            longitude: { type: 'number', nullable: true },
                         },
                     },
+                    resolvedTheater: {
+                        anyOf: [{ $ref: '#/components/schemas/CgvTheater' }, { type: 'null' }],
+                    },
                     movies: {
                         type: 'array',
                         items: { $ref: '#/components/schemas/CgvMovie' },
@@ -103,8 +121,14 @@ export const OPENAPI_CGV_COMPONENT_SCHEMAS = {
                         properties: {
                             theaterCode: { type: 'string', nullable: true },
                             movieCode: { type: 'string', nullable: true },
+                            keyword: { type: 'string', nullable: true },
+                            latitude: { type: 'number', nullable: true },
+                            longitude: { type: 'number', nullable: true },
                         },
                     },
+                    resolvedTheater: {
+                        anyOf: [{ $ref: '#/components/schemas/CgvTheater' }, { type: 'null' }],
+                    },
                     timetable: {
                         type: 'array',
                         items: { $ref: '#/components/schemas/CgvTimetable' },