daiso 1.0.3 → 1.0.5

package/openapi.yaml

@@ -1,21 +1,15 @@
 
 openapi: 3.1.0
 info:
-  title: 다이소 MCP API
+  title: 다이소 MCP API (OpenAI Actions용)
   description: |
-      다이소 제품 검색, 매장 찾기, 재고 확인을 위한 API입니다.
+      OpenAI 챗봇의 OpenAPI import 개수 제한을 피하기 위해 모든 GET API를 단일 facade 엔드포인트로 집약한 스펙입니다.
       
-      ## 주요 기능
-      - 🔍 **제품 검색**: 키워드로 다이소 제품 검색
-      - 🏪 **매장 찾기**: 지역/키워드로 매장 검색
-      - 📦 **재고 확인**: 온라인 및 오프라인 매장 재고 조회
-      - 🎬 **메가박스 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
-      - 🎥 **CGV 지점/영화 조회**: 극장 목록, 영화 목록, 시간표 조회
+      실제 런타임은 기존 /api/{service}/... 엔드포인트로 위임하며, 이 스펙은 OpenAI Actions 등록 전용으로 사용합니다.
       
-      ## 사용 팁
-      1. 한글 검색어는 URL 인코딩이 자동 처리됩니다
-      2. 재고 확인 시 먼저 제품 검색으로 제품 ID를 확인하세요
-      3. 위치 기반 재고 조회 시 lat, lng 파라미터를 활용하세요
+      브랜드명이 요청 앞부분에 나오면 뒤의 상품/재고 요청까지 같은 브랜드로 해석해야 합니다. 예: "안산 중앙역 주변 다이소 찾아주시고 핫식스 재고 찾아주세요"는 다이소 기준 조회를 먼저 수행하고, 결과가 없을 때만 다른 브랜드를 제안합니다.
+      
+      전체 개별 엔드포인트 스펙이 필요하면 /openapi-full.json 또는 /openapi-full.yaml 을 사용하세요.
   version: 1.0.0
   contact:
     name: GitHub Repository
@@ -24,618 +18,314 @@ servers:
   - url: "https://mcp.aka.page"
     description: Production Server
 paths:
-  /api/daiso/products:
+  /api/actions/query:
     get:
-      operationId: searchProducts
-      summary: 제품 검색
-      description: 키워드로 다이소 제품을 검색합니다. 수납박스, 펜, 정리함 등 다양한 키워드로 검색할 수 있습니다.
+      operationId: queryAction
+      summary: 공통 GET 액션 실행
+      description: action 값에 따라 기존 GET API 엔드포인트로 프록시합니다. OpenAI Actions 등록 시 이 단일 엔드포인트를 사용하세요.
       parameters:
-        - name: q
+        - name: action
           in: query
           required: true
-          description: "검색 키워드 (예: 수납박스, 펜, 정리함)"
+          description: 실행할 액션 이름입니다. 사용 가능한 값은 enum 목록을 참고하세요.
           schema:
             type: string
-          example: 수납박스
-        - name: page
+            enum:
+              - daisoSearchProducts
+              - daisoGetProduct
+              - daisoFindStores
+              - daisoCheckInventory
+              - daisoGetDisplayLocation
+              - oliveyoungSearchProducts
+              - oliveyoungFindStores
+              - oliveyoungCheckInventory
+              - cuFindStores
+              - cuCheckInventory
+              - emart24FindStores
+              - emart24SearchProducts
+              - emart24CheckInventory
+              - lottemartFindStores
+              - lottemartSearchProducts
+              - gs25FindStores
+              - gs25SearchProducts
+              - gs25CheckInventory
+              - sevenelevenSearchProducts
+              - sevenelevenSearchStores
+              - sevenelevenCheckInventory
+              - sevenelevenGetPopwords
+              - sevenelevenGetCatalog
+              - megaboxFindTheaters
+              - megaboxListMovies
+              - megaboxGetSeats
+              - lottecinemaFindTheaters
+              - lottecinemaListMovies
+              - lottecinemaGetSeats
+              - cgvFindTheaters
+              - cgvSearchMovies
+              - cgvGetTimetable
+        - name: q
           in: query
           required: false
-          description: 페이지 번호
+          description: 다이소 제품 검색어
           schema:
-            type: integer
-            default: 1
-            minimum: 1
-        - name: pageSize
+            type: string
+        - name: query
           in: query
           required: false
-          description: 페이지당 결과 수
-          schema:
-            type: integer
-            default: 30
-            minimum: 1
-            maximum: 100
-      responses:
-        200:
-          description: 검색 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProductSearchResponse"
-        400:
-          description: 잘못된 요청 (검색어 누락)
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/daiso/products/{productId}:
-    get:
-      operationId: getProduct
-      summary: 제품 상세 정보
-      description: 제품 ID로 상세 정보를 조회합니다.
-      parameters:
-        - name: productId
-          in: path
-          required: true
-          description: 제품 ID (제품 검색 결과의 id 값)
+          description: 세븐일레븐 상품 검색어
           schema:
             type: string
-          example: 1234567890
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProductDetailResponse"
-        404:
-          description: 제품을 찾을 수 없음
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/daiso/stores:
-    get:
-      operationId: findStores
-      summary: 매장 찾기
-      description: 키워드 또는 지역으로 다이소 매장을 검색합니다. keyword 또는 sido 중 하나는 필수입니다.
-      parameters:
-        - name: keyword
+        - name: itemCode
           in: query
           required: false
-          description: "매장명 또는 주소 키워드 (예: 강남, 홍대, 안산)"
+          description: GS25 상품 코드
           schema:
             type: string
-          example: 강남
-        - name: sido
+        - name: productId
           in: query
           required: false
-          description: "시/도 (예: 서울, 경기, 부산)"
+          description: 제품 ID 또는 상세 조회용 path 파라미터
           schema:
             type: string
-          example: 서울
-        - name: gugun
+        - name: keyword
           in: query
           required: false
-          description: "구/군 (예: 강남구, 마포구)"
+          description: 공통 키워드 파라미터
           schema:
             type: string
-          example: 강남구
-        - name: dong
+        - name: sido
           in: query
           required: false
-          description: "동 (예: 역삼동, 합정동)"
+          description: 다이소 시/도
           schema:
             type: string
-        - name: limit
+        - name: gugun
           in: query
           required: false
-          description: 최대 결과 수
-          schema:
-            type: integer
-            default: 50
-            minimum: 1
-            maximum: 100
-      responses:
-        200:
-          description: 검색 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/StoreSearchResponse"
-        400:
-          description: 잘못된 요청 (필수 파라미터 누락)
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/daiso/inventory:
-    get:
-      operationId: checkInventory
-      summary: 재고 확인
-      description: 특정 제품의 온라인 재고와 매장별 재고를 확인합니다. 위치 정보를 제공하면 가까운 매장 순으로 정렬됩니다.
-      parameters:
-        - name: productId
-          in: query
-          required: true
-          description: 제품 ID (제품 검색 결과의 id 값)
+          description: 다이소 구/군
           schema:
             type: string
-          example: 1234567890
-        - name: lat
+        - name: dong
           in: query
           required: false
-          description: "위도 (기본값: 서울 시청 37.5665)"
+          description: 다이소 동
           schema:
-            type: number
-            format: float
-            default: 37.5665
-          example: 37.4979
-        - name: lng
+            type: string
+        - name: area
           in: query
           required: false
-          description: "경도 (기본값: 서울 시청 126.978)"
+          description: 롯데마트 지역
           schema:
-            type: number
-            format: float
-            default: 126.978
-          example: 127.0276
-        - name: keyword
+            type: string
+        - name: area1
           in: query
           required: false
-          description: "매장 검색어 (예: 안산, 강남)"
+          description: 이마트24 1차 지역
           schema:
             type: string
-        - name: page
+        - name: area2
           in: query
           required: false
-          description: 페이지 번호
+          description: 이마트24 2차 지역
           schema:
-            type: integer
-            default: 1
-            minimum: 1
-        - name: pageSize
+            type: string
+        - name: areaCode
           in: query
           required: false
-          description: 페이지당 결과 수
+          description: 메가박스 지역 코드
           schema:
-            type: integer
-            default: 30
-            minimum: 1
-            maximum: 100
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/InventoryResponse"
-        400:
-          description: 잘못된 요청 (제품 ID 누락)
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/oliveyoung/stores:
-    get:
-      operationId: oliveyoungFindStores
-      summary: 올리브영 매장 검색
-      description: 위치(위도/경도)와 키워드로 올리브영 매장을 검색합니다.
-      parameters:
-        - name: keyword
+            type: string
+        - name: brandVariant
           in: query
           required: false
-          description: "매장명 또는 지역 키워드 (예: 명동, 강남)"
+          description: 롯데마트 브랜드 변형
           schema:
             type: string
-          example: 명동
         - name: lat
           in: query
           required: false
-          description: "위도 (기본값: 서울 시청 37.5665)"
+          description: 위도
           schema:
             type: number
             format: float
-            default: 37.5665
         - name: lng
           in: query
           required: false
-          description: "경도 (기본값: 서울 시청 126.978)"
+          description: 경도
           schema:
             type: number
             format: float
-            default: 126.978
-        - name: pageIdx
+        - name: page
           in: query
           required: false
-          description: 매장 검색 페이지 번호
+          description: 페이지 번호
           schema:
             type: integer
-            default: 1
-            minimum: 1
-        - name: limit
+        - name: pageIdx
           in: query
           required: false
-          description: 최대 결과 수
+          description: 올리브영 페이지 번호
           schema:
             type: integer
-            default: 20
-            minimum: 1
-            maximum: 100
-      responses:
-        200:
-          description: 검색 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/OliveyoungStoreSearchResponse"
-        500:
-          description: 올리브영 API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/oliveyoung/inventory:
-    get:
-      operationId: oliveyoungCheckInventory
-      summary: 올리브영 재고 확인
-      description: 상품 키워드로 올리브영 재고를 검색하고 주변 매장 정보를 함께 조회합니다.
-      parameters:
-        - name: keyword
-          in: query
-          required: true
-          description: 재고를 확인할 상품 키워드
-          schema:
-            type: string
-          example: 선크림
-        - name: lat
+        - name: pageLimit
           in: query
           required: false
-          description: "위도 (기본값: 서울 시청 37.5665)"
+          description: 롯데마트 추가 페이지 수
           schema:
-            type: number
-            format: float
-            default: 37.5665
-        - name: lng
+            type: integer
+        - name: pageSize
           in: query
           required: false
-          description: "경도 (기본값: 서울 시청 126.978)"
+          description: 페이지 크기
           schema:
-            type: number
-            format: float
-            default: 126.978
-        - name: storeKeyword
+            type: integer
+        - name: size
           in: query
           required: false
-          description: 주변 매장 필터 키워드
+          description: 페이지 크기 또는 검색 크기
           schema:
-            type: string
-        - name: page
+            type: integer
+        - name: offset
           in: query
           required: false
-          description: 상품 검색 페이지 번호
+          description: CU 검색 오프셋
           schema:
             type: integer
-            default: 1
-            minimum: 1
-        - name: size
+        - name: limit
           in: query
           required: false
-          description: 페이지당 결과 수
+          description: 최대 결과 수
           schema:
             type: integer
-            default: 20
-            minimum: 1
-            maximum: 100
-        - name: sort
+        - name: storeLimit
           in: query
           required: false
-          description: 정렬 코드
+          description: 매장 결과 제한 수
           schema:
-            type: string
-            default: 01
-        - name: includeSoldOut
+            type: integer
+        - name: storeCode
           in: query
           required: false
-          description: 품절 포함 여부 (true/false)
+          description: 매장 코드
           schema:
-            type: boolean
-            default: false
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/OliveyoungInventoryResponse"
-        400:
-          description: 잘못된 요청 (검색어 누락)
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-        500:
-          description: 올리브영 API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/megabox/theaters:
-    get:
-      operationId: megaboxFindNearbyTheaters
-      summary: 메가박스 주변 지점 조회
-      description: 좌표 기준으로 메가박스 지점을 거리순으로 조회합니다.
-      parameters:
-        - name: lat
+            type: string
+        - name: storeName
           in: query
           required: false
-          description: "위도 (기본값: 서울 시청 37.5665)"
+          description: 매장명
           schema:
-            type: number
-            format: float
-            default: 37.5665
-        - name: lng
+            type: string
+        - name: storeKeyword
           in: query
           required: false
-          description: "경도 (기본값: 서울 시청 126.978)"
+          description: 매장 키워드
           schema:
-            type: number
-            format: float
-            default: 126.978
+            type: string
         - name: playDate
           in: query
           required: false
-          description: 조회 날짜 (YYYYMMDD)
+          description: 상영일(YYYYMMDD)
           schema:
             type: string
-            example: 20260304
-        - name: areaCode
+        - name: regionCode
           in: query
           required: false
-          description: "지역 코드 (기본값: 11, 서울)"
+          description: CGV 지역 코드
           schema:
             type: string
-            default: 11
-        - name: limit
+        - name: theaterCode
           in: query
           required: false
-          description: 최대 결과 수
+          description: CGV 극장 코드
           schema:
-            type: integer
-            default: 10
-            minimum: 1
-            maximum: 100
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MegaboxTheaterSearchResponse"
-        500:
-          description: 메가박스 API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/megabox/movies:
-    get:
-      operationId: megaboxListNowShowing
-      summary: 메가박스 영화/회차 목록 조회
-      description: 날짜, 지점, 영화 조건으로 메가박스 영화 및 상영 회차를 조회합니다.
-      parameters:
-        - name: playDate
+            type: string
+        - name: theaterId
           in: query
           required: false
-          description: 조회 날짜 (YYYYMMDD)
+          description: 메가박스/롯데시네마 지점 ID
           schema:
             type: string
-            example: 20260304
-        - name: theaterId
+        - name: movieCode
           in: query
           required: false
-          description: "지점 ID (예: 1372)"
+          description: CGV 영화 코드
           schema:
             type: string
-            example: 1372
         - name: movieId
           in: query
           required: false
-          description: "영화 ID (예: 25104500)"
+          description: 메가박스/롯데시네마 영화 ID
           schema:
             type: string
-            example: 25104500
-        - name: areaCode
+        - name: pluCd
           in: query
           required: false
-          description: "지역 코드 (기본값: 11, 서울)"
+          description: 이마트24 상품 PLU 코드
           schema:
             type: string
-            default: 11
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MegaboxMovieListResponse"
-        500:
-          description: 메가박스 API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/megabox/seats:
-    get:
-      operationId: megaboxGetRemainingSeats
-      summary: 메가박스 잔여 좌석 조회
-      description: 영화/지점/날짜 조건으로 회차별 잔여 좌석 수를 조회합니다.
-      parameters:
-        - name: playDate
+        - name: bizNoArr
           in: query
           required: false
-          description: 조회 날짜 (YYYYMMDD)
+          description: 이마트24 사업자번호 목록
           schema:
             type: string
-            example: 20260304
-        - name: theaterId
+        - name: label
           in: query
           required: false
-          description: 지점 ID
+          description: 세븐일레븐 인기 검색어 라벨
           schema:
             type: string
-        - name: movieId
+        - name: sort
           in: query
           required: false
-          description: 영화 ID
+          description: 정렬 기준
           schema:
             type: string
-        - name: areaCode
+        - name: searchSort
           in: query
           required: false
-          description: "지역 코드 (기본값: 11, 서울)"
+          description: CU 검색 정렬 기준
           schema:
             type: string
-            default: 11
-        - name: limit
+        - name: service24h
           in: query
           required: false
-          description: 최대 결과 수
+          description: 이마트24 24시간 필터
           schema:
-            type: integer
-            default: 50
-            minimum: 1
-            maximum: 200
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MegaboxSeatListResponse"
-        500:
-          description: 메가박스 API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/cgv/theaters:
-    get:
-      operationId: cgvFindTheaters
-      summary: CGV 극장 목록 조회
-      description: 날짜/지역 코드 조건으로 CGV 극장 목록을 조회합니다.
-      parameters:
-        - name: playDate
+            type: boolean
+        - name: includeSoldOut
           in: query
           required: false
-          description: 조회 날짜 (YYYYMMDD)
+          description: 올리브영 품절 포함 여부
           schema:
-            type: string
-            example: 20260304
-        - name: regionCode
+            type: boolean
+        - name: includeIssues
           in: query
           required: false
-          description: "지역 코드 (예: 01 서울)"
+          description: 세븐일레븐 이달의 행사지 포함 여부
           schema:
-            type: string
-            example: 01
-        - name: limit
+            type: boolean
+        - name: includeExhibition
           in: query
           required: false
-          description: 최대 결과 수
+          description: 세븐일레븐 전시상품 포함 여부
+          schema:
+            type: boolean
+        - name: timeoutMs
+          in: query
+          required: false
+          description: 세븐일레븐 inventory 타임아웃
           schema:
             type: integer
-            default: 30
-            minimum: 1
-            maximum: 100
       responses:
         200:
-          description: 조회 성공
+          description: 프록시 호출 성공
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CgvTheaterSearchResponse"
-        500:
-          description: CGV API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/cgv/movies:
-    get:
-      operationId: cgvSearchMovies
-      summary: CGV 영화 목록 조회
-      description: 날짜/극장 조건으로 CGV 영화 목록을 조회합니다.
-      parameters:
-        - name: playDate
-          in: query
-          required: false
-          description: 조회 날짜 (YYYYMMDD)
-          schema:
-            type: string
-            example: 20260304
-        - name: theaterCode
-          in: query
-          required: false
-          description: "극장 코드 (예: 0056)"
-          schema:
-            type: string
-            example: 0056
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/CgvMovieSearchResponse"
-        500:
-          description: CGV API 호출 실패
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorResponse"
-  /api/cgv/timetable:
-    get:
-      operationId: cgvGetTimetable
-      summary: CGV 시간표 조회
-      description: 날짜/극장/영화 조건으로 CGV 상영 시간표를 조회합니다.
-      parameters:
-        - name: playDate
-          in: query
-          required: false
-          description: 조회 날짜 (YYYYMMDD)
-          schema:
-            type: string
-            example: 20260304
-        - name: theaterCode
-          in: query
-          required: false
-          description: 극장 코드
-          schema:
-            type: string
-        - name: movieCode
-          in: query
-          required: false
-          description: 영화 코드
-          schema:
-            type: string
-        - name: limit
-          in: query
-          required: false
-          description: 최대 결과 수
-          schema:
-            type: integer
-            default: 50
-            minimum: 1
-            maximum: 200
-      responses:
-        200:
-          description: 조회 성공
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/CgvTimetableResponse"
-        500:
-          description: CGV API 호출 실패
+                $ref: "#/components/schemas/ActionQueryResponse"
+        400:
+          description: 잘못된 요청
           content:
             application/json:
               schema:
@@ -661,7 +351,7 @@ components:
         imageUrl:
           type: string
           description: 제품 이미지 URL
-          example: "https://img.daisomall.co.kr/..."
+          example: "https://cdn.daisomall.co.kr/..."
         soldOut:
           type: boolean
           description: 품절 여부
@@ -703,6 +393,28 @@ components:
         isNew:
           type: boolean
           description: 신상품 여부
+    InventoryProduct:
+      type: object
+      description: 재고 응답에 포함되는 상품 요약 정보
+      properties:
+        id:
+          type: string
+          description: 제품 ID
+        name:
+          type: string
+          description: 제품명
+        imageUrl:
+          type: string
+          description: 제품 이미지 URL
+        brand:
+          type: string
+          description: 브랜드명
+        soldOut:
+          type: boolean
+          description: 품절 여부
+        isNew:
+          type: boolean
+          description: 신상품 여부
     Store:
       type: object
       description: 매장 정보
@@ -844,6 +556,8 @@ components:
             productId:
               type: string
               description: 제품 ID
+            product:
+              $ref: "#/components/schemas/InventoryProduct"
             location:
               type: object
               properties:
@@ -916,22 +630,910 @@ components:
         goodsName:
           type: string
           example: 달바 퍼플 톤업 선크림 듀오 기획
+        imageUrl:
+          type: string
+          example: "https://image.oliveyoung.co.kr/uploads/images/goods/10/0000/0020/A00000020061401ko.jpg"
         priceToPay:
           type: integer
-          example: 32130
-        originalPrice:
+          example: 32130
+        originalPrice:
+          type: integer
+          example: 51000
+        discountRate:
+          type: integer
+          example: 37
+        o2oStockFlag:
+          type: boolean
+          description: 올리브영 원본 재고 가능 플래그
+          example: true
+        o2oRemainQuantity:
+          type: integer
+          description: 올리브영 원본 잔여 수량 필드. 0이어도 재고가 있을 수 있음
+          example: 0
+        inStock:
+          type: boolean
+          description: 현재 조회한 주변 매장 기준 재고 여부. storeInventory가 있으면 그 결과를 우선 반영
+          example: true
+        stockStatus:
+          type: string
+          enum:
+            - in_stock
+            - out_of_stock
+          example: in_stock
+        stockSource:
+          type: string
+          enum:
+            - global_search
+            - nearby_store
+          example: nearby_store
+        storeInventory:
+          $ref: "#/components/schemas/OliveyoungProductStoreInventory"
+    OliveyoungStockStore:
+      type: object
+      description: 올리브영 상품별 매장 재고 상태
+      properties:
+        storeCode:
+          type: string
+          example: B040
+        storeName:
+          type: string
+          example: 안산중앙역점
+        address:
+          type: string
+          example: 경기도 안산시 단원구 고잔2길 65 1층
+        latitude:
+          type: number
+          format: float
+          example: 37.3177184
+        longitude:
+          type: number
+          format: float
+          example: 126.8385857
+        distance:
+          type: number
+          format: float
+          example: 0.07
+        pickupYn:
+          type: boolean
+          example: true
+        salesStoreYn:
+          type: boolean
+          example: true
+        remainQuantity:
+          type: integer
+          example: 3
+        o2oRemainQuantity:
+          type: integer
+          example: 2
+        stockStatus:
+          type: string
+          enum:
+            - in_stock
+            - out_of_stock
+            - not_sold
+          example: in_stock
+        stockLabel:
+          type: string
+          example: 재고 3개
+        openYn:
+          type: boolean
+          example: true
+    OliveyoungProductStoreInventory:
+      type: object
+      properties:
+        totalCount:
+          type: integer
+          example: 1
+        inStockCount:
+          type: integer
+          example: 1
+        outOfStockCount:
+          type: integer
+          example: 0
+        notSoldCount:
+          type: integer
+          example: 0
+        stores:
+          type: array
+          items:
+            $ref: "#/components/schemas/OliveyoungStockStore"
+    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
+    OliveyoungProductSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            keyword:
+              type: string
+              example: 마스크팩
+            count:
+              type: integer
+              example: 2
+            products:
+              type: array
+              items:
+                $ref: "#/components/schemas/OliveyoungProduct"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+            nextPage:
+              type: boolean
+    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
+                stockCheckedCount:
+                  type: integer
+                stockUncheckedCount:
+                  type: integer
+                inStockCount:
+                  type: integer
+                outOfStockCount:
+                  type: integer
+                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:
+      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
+            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"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+    MegaboxSeatListResponse:
+      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"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            pageSize:
+              type: integer
+    CuStore:
+      type: object
+      description: CU 매장 정보
+      properties:
+        storeCode:
+          type: string
+          example: 28376
+        storeName:
+          type: string
+          example: 중앙하이츠빌점
+        phone:
+          type: string
+          example: 0315088023
+        address:
+          type: string
+          example: 경기도 안산시 단원구 안산천서로 23
+        latitude:
+          type: number
+          format: float
+          example: 37.318482
+        longitude:
+          type: number
+          format: float
+          example: 126.841838
+        distanceM:
+          type: number
+          example: 97
+        stock:
+          type: integer
+          example: 10
+        deliveryYn:
+          type: boolean
+          example: true
+        pickupYn:
+          type: boolean
+          example: false
+        reserveYn:
+          type: boolean
+          example: false
+    CuInventoryItem:
+      type: object
+      description: CU 재고 검색 상품
+      properties:
+        itemCode:
+          type: string
+          example: 8801728108946
+        itemName:
+          type: string
+          example: 바삭한 감자칩
+        price:
+          type: integer
+          example: 1700
+        pickupYn:
+          type: boolean
+          example: true
+        deliveryYn:
+          type: boolean
+          example: true
+        reserveYn:
+          type: boolean
+          example: false
+    CuStoreSearchResponse:
+      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
+            keyword:
+              type: string
+            stores:
+              type: array
+              items:
+                $ref: "#/components/schemas/CuStore"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            pageSize:
+              type: integer
+    CuInventoryResponse:
+      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/CuStore"
+            inventory:
+              type: object
+              properties:
+                totalCount:
+                  type: integer
+                spellModifyYn:
+                  type: string
+                  example: Y
+                items:
+                  type: array
+                  items:
+                    $ref: "#/components/schemas/CuInventoryItem"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+    Emart24Store:
+      type: object
+      properties:
+        storeCode:
+          type: string
+          example: 28339
+        storeName:
+          type: string
+          example: 강남스퀘어점
+        address:
+          type: string
+          example: 서울특별시 강남구 강남대로 396
+        phone:
+          type: string
+          example: 02-000-0000
+        latitude:
+          type: number
+          format: float
+          example: 37.4982
+        longitude:
+          type: number
+          format: float
+          example: 127.0276
+        service24h:
+          type: boolean
+          example: true
+        distanceM:
+          type: number
+          nullable: true
+          example: 120
+    Emart24Product:
+      type: object
+      properties:
+        pluCd:
+          type: string
+          example: 8800244010504
+        goodsName:
+          type: string
+          example: 두바이초콜릿
+        originPrice:
+          type: integer
+          example: 3500
+        viewPrice:
+          type: integer
+          example: 3000
+        category:
+          type: string
+          example: 간식
+        kind:
+          type: string
+          example: 초콜릿
+    Emart24StoreSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            stores:
+              type: array
+              items:
+                $ref: "#/components/schemas/Emart24Store"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+    Emart24ProductSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            products:
+              type: array
+              items:
+                $ref: "#/components/schemas/Emart24Product"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+    Emart24InventoryResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            keyword:
+              type: string
+              example: 고양이 츄르
+            pluCd:
+              type: string
+              example: 8800244010504
+            productCandidates:
+              type: array
+              items:
+                $ref: "#/components/schemas/Emart24Product"
+            location:
+              type: object
+              nullable: true
+              properties:
+                latitude:
+                  type: number
+                  format: float
+                longitude:
+                  type: number
+                  format: float
+            storeFilters:
+              type: object
+              properties:
+                storeKeyword:
+                  type: string
+                  example: 안산 중앙역
+                appliedStoreKeyword:
+                  type: string
+                  example: 안산중앙역
+                area1:
+                  type: string
+                  example: 경기도
+                area2:
+                  type: string
+                  example: 안산시
+                service24h:
+                  type: boolean
+                  example: false
+                storeLimit:
+                  type: integer
+                  example: 10
+                directBizNos:
+                  type: array
+                  items:
+                    type: string
+                    example: 28339
+            nearbyStores:
+              type: object
+              properties:
+                totalCount:
+                  type: integer
+                  example: 3
+                stores:
+                  type: array
+                  items:
+                    $ref: "#/components/schemas/Emart24Store"
+            goodsInfo:
+              type: object
+              nullable: true
+            count:
+              type: integer
+              example: 1
+            stores:
+              type: array
+              items:
+                type: object
+                properties:
+                  bizNo:
+                    type: string
+                    example: 28339
+                  bizQty:
+                    type: integer
+                    example: 3
+                  storeName:
+                    type: string
+                    example: 강남스퀘어점
+                  address:
+                    type: string
+                  phone:
+                    type: string
+                  distanceM:
+                    type: number
+                    nullable: true
+                    example: 120
+    LotteMartStore:
+      type: object
+      properties:
+        area:
+          type: string
+          example: 서울
+        storeCode:
+          type: string
+          example: 2301
+        storeName:
+          type: string
+          example: 강변점
+        brandVariant:
+          type: string
+          example: lottemart
+        address:
+          type: string
+          example: 서울 광진구 광나루로 56길 85 테크노마트 B2
+        phone:
+          type: string
+          example: 02-3424-2502
+        openTime:
+          type: string
+          example: "10:00~23:00"
+        closedDays:
+          type: string
+          example: 03/08(일), 03/22(일)
+        parkingType:
+          type: string
+          example: 유료
+        parkingDetails:
+          type: string
+          example: "최초 무료주차 : 1시간"
+        detailUrl:
+          type: string
+          example: /mobiledowa/market/detail_shop.asp?werks=2301
+        latitude:
+          type: number
+          format: float
+          example: 37.5354
+        longitude:
+          type: number
+          format: float
+          example: 127.0958
+        distanceM:
+          type: number
+          nullable: true
+          example: 530
+    LotteMartProduct:
+      type: object
+      properties:
+        area:
+          type: string
+          example: 서울
+        storeCode:
+          type: string
+          example: 2301
+        storeName:
+          type: string
+          example: 강변점
+        keyword:
+          type: string
+          example: 콜라
+        productName:
+          type: string
+          example: 코카콜라
+        barcode:
+          type: string
+          example: 8801094011307
+        spec:
+          type: string
+          example: 1.2L
+        manufacturer:
+          type: string
+          example: 코카콜라음료 주식회사
+        price:
+          type: integer
+          example: 2980
+        stockQuantity:
+          type: integer
+          example: 20
+    LotteMartStoreSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            stores:
+              type: array
+              items:
+                $ref: "#/components/schemas/LotteMartStore"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+    LotteMartProductSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            products:
+              type: array
+              items:
+                $ref: "#/components/schemas/LotteMartProduct"
+        meta:
+          type: object
+          properties:
+            total:
+              type: integer
+            page:
+              type: integer
+            pageSize:
+              type: integer
+    Gs25Store:
+      type: object
+      properties:
+        storeCode:
+          type: string
+          example: VE463
+        storeName:
+          type: string
+          example: 강남역점
+        address:
+          type: string
+          example: 서울특별시 강남구 강남대로 396
+        phone:
+          type: string
+          example: 02-1234-5678
+        latitude:
+          type: number
+          format: float
+          example: 37.4982
+        longitude:
+          type: number
+          format: float
+          example: 127.0276
+        realStockQuantity:
+          type: integer
+          example: 3
+        distanceM:
+          type: number
+          nullable: true
+          example: 120
+        propertyNames:
+          type: array
+          items:
+            type: string
+          example:
+            - 반값택배픽업
+            - 와인25플러스
+    Gs25ProductCandidate:
+      type: object
+      properties:
+        name:
+          type: string
+          example: 오리온)오감자50G
+        sellPrice:
+          type: integer
+          nullable: true
+          example: 1700
+        matchedStoreCount:
           type: integer
-          example: 51000
-        discountRate:
+          example: 120
+        inStockStoreCount:
           type: integer
-          example: 37
-        o2oStockFlag:
-          type: boolean
-          example: true
-        o2oRemainQuantity:
+          example: 42
+        totalStockQuantity:
           type: integer
-          example: 0
-    OliveyoungStoreSearchResponse:
+          example: 110
+    Gs25StoreSearchResponse:
       type: object
       properties:
         success:
@@ -943,17 +1545,35 @@ components:
             stores:
               type: array
               items:
-                $ref: "#/components/schemas/OliveyoungStore"
+                $ref: "#/components/schemas/Gs25Store"
         meta:
           type: object
           properties:
             total:
               type: integer
-            page:
+            pageSize:
+              type: integer
+    Gs25ProductSearchResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            products:
+              type: array
+              items:
+                $ref: "#/components/schemas/Gs25ProductCandidate"
+        meta:
+          type: object
+          properties:
+            total:
               type: integer
             pageSize:
               type: integer
-    OliveyoungInventoryResponse:
+    Gs25InventoryResponse:
       type: object
       properties:
         success:
@@ -964,103 +1584,272 @@ components:
           properties:
             keyword:
               type: string
-              example: 선크림
-            location:
+              example: 오감자
+            product:
               type: object
               properties:
-                latitude:
-                  type: number
-                  format: float
-                longitude:
-                  type: number
-                  format: float
-            nearbyStores:
+                name:
+                  type: string
+                  nullable: true
+                  example: 오리온)오감자50G
+                sellPrice:
+                  type: integer
+                  nullable: true
+                  example: 1700
+            inventory:
               type: object
               properties:
-                totalCount:
+                totalStoreCount:
                   type: integer
+                  example: 17684
+                matchedStoreCount:
+                  type: integer
+                  example: 100
+                inStockStoreCount:
+                  type: integer
+                  example: 35
+                totalStockQuantity:
+                  type: integer
+                  example: 90
                 stores:
                   type: array
                   items:
-                    $ref: "#/components/schemas/OliveyoungStore"
+                    $ref: "#/components/schemas/Gs25Store"
+    SevenElevenProduct:
+      type: object
+      properties:
+        itemCode:
+          type: string
+          example: 8801056252243
+        itemName:
+          type: string
+          example: 칠성)핫식스더킹퍼플500ml
+        salePrice:
+          type: integer
+          nullable: true
+          example: 3000
+        imageUrl:
+          type: string
+          nullable: true
+          example: 
+    SevenElevenStockError:
+      type: object
+      nullable: true
+      properties:
+        cause:
+          type: string
+          example: api
+        httpStatus:
+          type: integer
+          nullable: true
+          example: 400
+        code:
+          type: integer
+          nullable: true
+          example: 501
+        message:
+          type: string
+          example: RSA 복호화 실패
+        raw:
+          type: string
+          nullable: true
+    SevenElevenStoreInventory:
+      type: object
+      properties:
+        storeCode:
+          type: string
+          example: 54928
+        storeName:
+          type: string
+          example: 안산중앙일번가점
+        address:
+          type: string
+          example: 경기 안산시 단원구 중앙대로 907 2동 2121호
+        latitude:
+          type: number
+          format: float
+          example: 37.317371500357
+        longitude:
+          type: number
+          format: float
+          example: 126.837004318586
+        stockQuantity:
+          type: integer
+          example: 14
+        isSoldOut:
+          type: boolean
+          example: false
+        distanceM:
+          type: integer
+          nullable: true
+          example: 100
+    SevenElevenInventoryResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          properties:
+            keyword:
+              type: string
+              example: 핫식스
+            storeKeyword:
+              type: string
+              example: 안산 중앙역
+            product:
+              anyOf:
+                - $ref: "#/components/schemas/SevenElevenProduct"
+                - type: null
+            stockAvailable:
+              type: boolean
+              example: true
+            stockError:
+              $ref: "#/components/schemas/SevenElevenStockError"
+            note:
+              type: string
+              example: 실시간 재고 데이터가 포함되어 있습니다.
             inventory:
               type: object
               properties:
-                totalCount:
+                totalStoreCount:
                   type: integer
-                nextPage:
-                  type: boolean
-                products:
+                  example: 4
+                inStockStoreCount:
+                  type: integer
+                  example: 3
+                count:
+                  type: integer
+                  example: 4
+                stores:
                   type: array
                   items:
-                    $ref: "#/components/schemas/OliveyoungProduct"
+                    $ref: "#/components/schemas/SevenElevenStoreInventory"
         meta:
           type: object
           properties:
             total:
               type: integer
-            page:
-              type: integer
+              example: 4
             pageSize:
               type: integer
-    MegaboxTheater:
+              example: 10
+    LotteCinemaTheater:
       type: object
       properties:
         theaterId:
           type: string
-          example: 1372
+          example: 1016
         theaterName:
           type: string
-          example: 강남
+          example: 월드타워
+        regionCode:
+          type: string
+          example: 1
+        regionDetailCode:
+          type: string
+          example: 0001
         address:
           type: string
-          example: 서울특별시 강남구 강남대로 438
+          example: 서울 송파구 올림픽로 300
         latitude:
           type: number
           format: float
-          example: 37.4982
+          example: 37.5132941
         longitude:
           type: number
           format: float
-          example: 127.0264
+          example: 127.104215
         distanceKm:
           type: number
           format: float
           example: 0.5
-    MegaboxShowtime:
+    LotteCinemaResolvedLocation:
       type: object
       properties:
-        scheduleId:
+        keyword:
           type: string
-          example: 2603041372011
+          nullable: true
+          example: 안산 중앙역
+        latitude:
+          type: number
+          format: float
+          nullable: true
+          example: 37.3172
+        longitude:
+          type: number
+          format: float
+          nullable: true
+          example: 126.839
+        geocodeUsed:
+          type: boolean
+          example: true
+        formattedAddress:
+          type: string
+          nullable: true
+          example: 대한민국 경기도 안산시 단원구 고잔동 535
+    LotteCinemaMovie:
+      type: object
+      properties:
         movieId:
           type: string
-          example: 25104500
+          example: 23816
         movieName:
           type: string
-          example: 미키 17
+          example: 왕과 사는 남자
+        rating:
+          type: string
+          example: 12세이상관람가
+        durationMinutes:
+          type: integer
+          example: 127
+        releaseDate:
+          type: string
+          example: 2026-03-10
+    LotteCinemaShowtime:
+      type: object
+      properties:
+        scheduleId:
+          type: string
+          example: 20260310-1016-1201-1
         theaterId:
           type: string
-          example: 1372
+          example: 1016
         theaterName:
           type: string
-          example: 강남
+          example: 월드타워
+        movieId:
+          type: string
+          example: 23816
+        movieName:
+          type: string
+          example: 왕과 사는 남자
+        screenId:
+          type: string
+          example: 1201
+        screenName:
+          type: string
+          example: 1관 샤롯데
         playDate:
           type: string
-          example: 20260304
+          example: 20260310
         startTime:
           type: string
-          example: "09:30"
+          example: "10:40"
         endTime:
           type: string
-          example: "11:20"
+          example: "12:47"
         totalSeats:
           type: integer
-          example: 120
+          example: 32
+        bookedSeats:
+          type: integer
+          example: 28
         remainingSeats:
           type: integer
-          example: 42
-    MegaboxTheaterSearchResponse:
+          example: 4
+    LotteCinemaTheaterSearchResponse:
       type: object
       properties:
         success:
@@ -1069,23 +1858,28 @@ components:
         data:
           type: object
           properties:
-            location:
-              type: object
-              properties:
-                latitude:
-                  type: number
-                  format: float
-                longitude:
-                  type: number
-                  format: float
-            playDate:
+            keyword:
               type: string
-            areaCode:
+              nullable: true
+            latitude:
+              type: number
+              format: float
+              nullable: true
+            longitude:
+              type: number
+              format: float
+              nullable: true
+            geocodeUsed:
+              type: boolean
+            formattedAddress:
+              type: string
+              nullable: true
+            playDate:
               type: string
             theaters:
               type: array
               items:
-                $ref: "#/components/schemas/MegaboxTheater"
+                $ref: "#/components/schemas/LotteCinemaTheater"
         meta:
           type: object
           properties:
@@ -1093,7 +1887,7 @@ components:
               type: integer
             pageSize:
               type: integer
-    MegaboxMovieListResponse:
+    LotteCinemaMovieListResponse:
       type: object
       properties:
         success:
@@ -1113,38 +1907,39 @@ components:
                 movieId:
                   type: string
                   nullable: true
-                areaCode:
+                keyword:
                   type: string
+                  nullable: true
+                latitude:
+                  type: number
+                  format: float
+                  nullable: true
+                longitude:
+                  type: number
+                  format: float
+                  nullable: true
+            resolvedTheater:
+              anyOf:
+                - $ref: "#/components/schemas/LotteCinemaTheater"
+                - type: null
             theaters:
               type: array
               items:
-                type: object
-                properties:
-                  theaterId:
-                    type: string
-                  theaterName:
-                    type: string
+                $ref: "#/components/schemas/LotteCinemaTheater"
             movies:
               type: array
               items:
-                type: object
-                properties:
-                  movieId:
-                    type: string
-                  movieName:
-                    type: string
-                  movieStatus:
-                    type: string
+                $ref: "#/components/schemas/LotteCinemaMovie"
             showtimes:
               type: array
               items:
-                $ref: "#/components/schemas/MegaboxShowtime"
+                $ref: "#/components/schemas/LotteCinemaShowtime"
         meta:
           type: object
           properties:
             total:
               type: integer
-    MegaboxSeatListResponse:
+    LotteCinemaSeatListResponse:
       type: object
       properties:
         success:
@@ -1164,12 +1959,25 @@ components:
                 movieId:
                   type: string
                   nullable: true
-                areaCode:
+                keyword:
                   type: string
+                  nullable: true
+                latitude:
+                  type: number
+                  format: float
+                  nullable: true
+                longitude:
+                  type: number
+                  format: float
+                  nullable: true
+            resolvedTheater:
+              anyOf:
+                - $ref: "#/components/schemas/LotteCinemaTheater"
+                - type: null
             seats:
               type: array
               items:
-                $ref: "#/components/schemas/MegaboxShowtime"
+                $ref: "#/components/schemas/LotteCinemaShowtime"
         meta:
           type: object
           properties:
@@ -1189,6 +1997,22 @@ components:
         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:
       type: object
       properties:
@@ -1251,6 +2075,29 @@ components:
                 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:
@@ -1279,6 +2126,19 @@ components:
                 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:
@@ -1308,6 +2168,19 @@ components:
                 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:
@@ -1336,3 +2209,17 @@ components:
               type: string
               description: 에러 메시지
               example: 검색어(q)를 입력해주세요.
+    ActionQueryResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: true
+        data:
+          type: object
+          additionalProperties: true
+          description: 대상 엔드포인트가 반환한 data 객체
+        meta:
+          type: object
+          additionalProperties: true
+          description: 대상 엔드포인트가 반환한 meta 객체