daiso 1.0.4 → 1.0.5

package/dist/index.js

@@ -13,16 +13,33 @@ import { createDaisoService } from './services/daiso/index.js';
 import { createOliveyoungService } from './services/oliveyoung/index.js';
 import { createMegaboxService } from './services/megabox/index.js';
 import { createCgvService } from './services/cgv/index.js';
+import { createLotteCinemaService } from './services/lottecinema/index.js';
+import { createLotteMartService } from './services/lottemart/index.js';
+import { createCuService } from './services/cu/index.js';
+import { createEmart24Service } from './services/emart24/index.js';
+import { createGs25Service } from './services/gs25/index.js';
+import { createSevenElevenService } from './services/seveneleven/index.js';
 import { createPromptResponse } from './pages/prompt.js';
-import { createOpenApiJsonResponse, createOpenApiYamlResponse } from './pages/openapi.js';
+import { createFullOpenApiJsonResponse, createFullOpenApiYamlResponse, createOpenApiJsonResponse, createOpenApiYamlResponse, } from './pages/openapi.js';
 import { createPrivacyResponse } from './pages/privacy.js';
+import { buildActionQueryTargetUrl } from './api/actionsProxy.js';
 import { registerDaisoRoutes } from './api/routes/daisoRoutes.js';
 import { registerOliveyoungRoutes } from './api/routes/oliveyoungRoutes.js';
 import { registerMegaboxRoutes } from './api/routes/megaboxRoutes.js';
 import { registerCgvRoutes } from './api/routes/cgvRoutes.js';
+import { registerLotteCinemaRoutes } from './api/routes/lottecinemaRoutes.js';
+import { registerLotteMartRoutes } from './api/routes/lottemartRoutes.js';
+import { registerCuRoutes } from './api/routes/cuRoutes.js';
+import { registerEmart24Routes } from './api/routes/emart24Routes.js';
+import { registerGs25Routes } from './api/routes/gs25Routes.js';
+import { registerSevenElevenRoutes } from './api/routes/sevenelevenRoutes.js';
+import { registerHealthRoutes } from './api/routes/healthRoutes.js';
 // 서버 메타데이터
 const SERVER_NAME = 'multi-service-mcp';
 const SERVER_VERSION = '1.0.0';
+const SESSION_HEADER = 'mcp-session-id';
+// 세션별 MCP 전송 계층/서버를 유지해 GET/POST/DELETE를 일관 처리합니다.
+const mcpSessions = new Map();
 /**
  * 요청 컨텍스트 기반 서비스 레지스트리 생성
  */
@@ -30,9 +47,21 @@ const createRegistry = (bindings) => {
     const registry = new ServiceRegistry();
     registry.registerAll([
         createDaisoService,
+        createGs25Service,
+        createSevenElevenService,
+        createCuService,
+        createEmart24Service,
+        () => createLotteMartService({
+            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+            zyteApiKey: bindings?.ZYTE_API_KEY,
+        }),
         createMegaboxService,
+        () => createLotteCinemaService({
+            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
+        }),
         () => createCgvService({
             zyteApiKey: bindings?.ZYTE_API_KEY,
+            googleMapsApiKey: bindings?.GOOGLE_MAPS_API_KEY,
         }),
         () => createOliveyoungService({
             zyteApiKey: bindings?.ZYTE_API_KEY,
@@ -52,13 +81,88 @@ const createMcpServer = (bindings) => {
     registry.applyToServer(server);
     return server;
 };
+/**
+ * initialize 요청 여부를 확인합니다.
+ */
+const isInitializeRequest = (body) => {
+    if (Array.isArray(body)) {
+        return body.some((item) => typeof item === 'object' && item !== null && item.method === 'initialize');
+    }
+    return typeof body === 'object' && body !== null && body.method === 'initialize';
+};
+/**
+ * 새 세션 transport/server를 생성합니다.
+ */
+const createSessionTransport = (bindings) => {
+    const server = createMcpServer(bindings);
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: () => crypto.randomUUID(),
+        onsessioninitialized: (sessionId) => {
+            mcpSessions.set(sessionId, { server, transport });
+        },
+        onsessionclosed: (sessionId) => {
+            mcpSessions.delete(sessionId);
+        },
+    });
+    return { server, transport };
+};
+/**
+ * /mcp 요청을 세션 기반으로 처리합니다.
+ */
+const handleMcpRequest = async (c) => {
+    const sessionId = c.req.header(SESSION_HEADER);
+    if (sessionId) {
+        const existing = mcpSessions.get(sessionId);
+        if (!existing) {
+            if (c.req.method === 'POST') {
+                const transport = new WebStandardStreamableHTTPServerTransport();
+                const server = createMcpServer(c.env);
+                await server.connect(transport);
+                const response = await transport.handleRequest(c.req.raw);
+                response.headers.set('x-mcp-session-fallback', 'stateless');
+                return response;
+            }
+            return c.json({
+                error: 'Session not found',
+                message: '유효하지 않은 mcp-session-id 입니다. initialize 요청부터 다시 시작해주세요.',
+            }, 404);
+        }
+        return existing.transport.handleRequest(c.req.raw);
+    }
+    if (c.req.method === 'POST') {
+        const parsedBody = await c.req.raw
+            .clone()
+            .json()
+            .catch(() => undefined);
+        if (!isInitializeRequest(parsedBody)) {
+            return c.json({
+                error: 'Bad Request',
+                message: '세션이 없습니다. 먼저 initialize 요청으로 세션을 생성해주세요.',
+            }, 400);
+        }
+        const { server, transport } = createSessionTransport(c.env);
+        await server.connect(transport);
+        return transport.handleRequest(c.req.raw, { parsedBody });
+    }
+    return c.json({
+        error: 'Bad Request',
+        message: `세션이 없습니다. 먼저 POST /mcp initialize 요청 후 ${SESSION_HEADER} 헤더를 사용해주세요.`,
+    }, 400);
+};
 // Hono 앱 생성
 const app = new Hono();
 // CORS 설정
 app.use('*', cors({
     origin: '*',
     allowMethods: ['GET', 'POST', 'DELETE', 'OPTIONS'],
-    allowHeaders: ['Content-Type', 'mcp-session-id', 'Last-Event-ID', 'mcp-protocol-version'],
+    allowHeaders: [
+        'Content-Type',
+        'Authorization',
+        'x-health-check-key',
+        'mcp-session-id',
+        'Last-Event-ID',
+        'mcp-protocol-version',
+    ],
     exposeHeaders: ['mcp-session-id', 'mcp-protocol-version'],
 }));
 // 기본 정보 엔드포인트 (GET 요청만)
@@ -73,6 +177,10 @@ app.get('/', (c) => {
         endpoints: {
             mcp: '/ 또는 /mcp (POST) - MCP 프로토콜 엔드포인트',
             health: '/health (GET) - 헬스 체크',
+            healthChecks: '/api/health/checks (GET) - 서비스별 상세 헬스 체크',
+            openapi: '/openapi.json (GET) - OpenAI Actions용 축약 OpenAPI',
+            openapiFull: '/openapi-full.json (GET) - 전체 OpenAPI',
+            actionsQuery: '/api/actions/query (GET) - 기존 GET API 통합 facade',
         },
         services,
         tools: allTools,
@@ -89,6 +197,7 @@ app.on(['POST', 'DELETE', 'OPTIONS'], '/', async (c) => {
 });
 // 헬스 체크 엔드포인트
 app.get('/health', (c) => c.json({ status: 'ok' }));
+registerHealthRoutes(app);
 // 프롬프트 페이지 (MCP 미지원 에이전트용)
 app.get('/prompt', (c) => {
     const baseUrl = new URL(c.req.url).origin;
@@ -103,6 +212,14 @@ app.get('/openapi.yaml', (c) => {
     const baseUrl = new URL(c.req.url).origin;
     return createOpenApiYamlResponse(baseUrl);
 });
+app.get('/openapi-full.json', (c) => {
+    const baseUrl = new URL(c.req.url).origin;
+    return createFullOpenApiJsonResponse(baseUrl);
+});
+app.get('/openapi-full.yaml', (c) => {
+    const baseUrl = new URL(c.req.url).origin;
+    return createFullOpenApiYamlResponse(baseUrl);
+});
 // 개인정보 처리방침 페이지
 app.get('/privacy', (c) => {
     const baseUrl = new URL(c.req.url).origin;
@@ -110,14 +227,36 @@ app.get('/privacy', (c) => {
 });
 // GET API 엔드포인트 (MCP 미지원 에이전트용)
 registerDaisoRoutes(app);
+registerGs25Routes(app);
+registerSevenElevenRoutes(app);
+registerCuRoutes(app);
+registerEmart24Routes(app);
+registerLotteMartRoutes(app);
 registerOliveyoungRoutes(app);
 registerMegaboxRoutes(app);
+registerLotteCinemaRoutes(app);
 registerCgvRoutes(app);
-// MCP 엔드포인트
-app.all('/mcp', async (c) => {
-    const transport = new WebStandardStreamableHTTPServerTransport();
-    const server = createMcpServer(c.env);
-    await server.connect(transport);
-    return transport.handleRequest(c.req.raw);
+app.get('/api/actions/query', async (c) => {
+    try {
+        const targetUrl = buildActionQueryTargetUrl(c.req.url);
+        const headers = new Headers(c.req.raw.headers);
+        headers.delete('host');
+        return app.fetch(new Request(targetUrl.toString(), {
+            method: 'GET',
+            headers,
+        }), c.env);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return c.json({
+            success: false,
+            error: {
+                code: 'INVALID_ACTION_QUERY',
+                message,
+            },
+        }, 400);
+    }
 });
+// MCP 엔드포인트
+app.all('/mcp', handleMcpRequest);
 export default app;

package/dist/pages/openapi.js

@@ -2,5 +2,6 @@
  * OpenAPI 페이지 엔트리
  */
 export { generateOpenApiSpec } from './openapiSpec.js';
-export { createOpenApiJsonResponse, createOpenApiYamlResponse } from './openapiResponse.js';
+export { generateFullOpenApiSpec } from './openapiFullSpec.js';
+export { createOpenApiJsonResponse, createOpenApiYamlResponse, createFullOpenApiJsonResponse, createFullOpenApiYamlResponse, } from './openapiResponse.js';
 export { __testOnlyJsonToYaml } from './openapiYaml.js';

package/dist/pages/openapiFullSpec.js

@@ -0,0 +1,58 @@
+/**
+ * 전체 OpenAPI 스펙 조합 모듈
+ */
+import { OPENAPI_PATHS_DAISO_OLIVEYOUNG } from './openapiSpecPathsDaisoOliveyoung.js';
+import { OPENAPI_PATHS_CU } from './openapiSpecPathsCu.js';
+import { OPENAPI_PATHS_EMART24 } from './openapiSpecPathsEmart24.js';
+import { OPENAPI_PATHS_LOTTEMART } from './openapiSpecPathsLotteMart.js';
+import { OPENAPI_PATHS_MEGABOX } from './openapiSpecPathsMegabox.js';
+import { OPENAPI_PATHS_CGV } from './openapiSpecPathsCgv.js';
+import { OPENAPI_PATHS_LOTTECINEMA } from './openapiSpecPathsLottecinema.js';
+import { OPENAPI_PATHS_GS25 } from './openapiSpecPathsGs25.js';
+import { OPENAPI_PATHS_SEVENELEVEN } from './openapiSpecPathsSeveneleven.js';
+import { OPENAPI_COMPONENTS } from './openapiSpecComponents.js';
+export function generateFullOpenApiSpec(baseUrl) {
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: '다이소 MCP API (전체 스펙)',
+            description: `다이소 제품 검색, 매장 찾기, 재고 확인을 위한 API입니다.
+
+## 주요 기능
+- 🔍 **제품 검색**: 키워드로 다이소 제품 검색
+- 🏪 **매장 찾기**: 지역/키워드로 매장 검색
+- 📦 **재고 확인**: 온라인 및 오프라인 매장 재고 조회
+- 🧭 **진열 위치 조회**: 매장 내 상품 구역/층 정보 조회
+- 🏪 **GS25 매장/상품/재고 조회**: GS25 매장 탐색, 상품 검색, 재고 조회
+- 7️⃣ **세븐일레븐 상품/매장/재고 조회**: 상품 검색, 매장 검색, 실재고 조회
+- 🏪 **CU 매장/재고 조회**: CU 매장 탐색 및 상품 재고 검색
+- 🎬 **메가박스 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
+- 🎞️ **롯데시네마 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
+- 🎥 **CGV 지점/영화 조회**: 극장 목록, 영화 목록, 시간표 조회
+
+## 사용 팁
+1. 한글 검색어는 URL 인코딩이 자동 처리됩니다
+2. 재고 확인 시 먼저 제품 검색으로 제품 ID를 확인하세요
+3. 위치 기반 재고 조회 시 lat, lng 파라미터를 활용하세요
+4. 세븐일레븐 재고 조회는 keyword와 storeKeyword를 함께 사용하면 정확도가 높아집니다`,
+            version: '1.0.0',
+            contact: {
+                name: 'GitHub Repository',
+                url: 'https://github.com/hmmhmmhm/daiso-mcp',
+            },
+        },
+        servers: [{ url: baseUrl, description: 'Production Server' }],
+        paths: {
+            ...OPENAPI_PATHS_DAISO_OLIVEYOUNG,
+            ...OPENAPI_PATHS_CU,
+            ...OPENAPI_PATHS_EMART24,
+            ...OPENAPI_PATHS_LOTTEMART,
+            ...OPENAPI_PATHS_GS25,
+            ...OPENAPI_PATHS_SEVENELEVEN,
+            ...OPENAPI_PATHS_MEGABOX,
+            ...OPENAPI_PATHS_LOTTECINEMA,
+            ...OPENAPI_PATHS_CGV,
+        },
+        components: OPENAPI_COMPONENTS,
+    };
+}

package/dist/pages/openapiResponse.js

@@ -2,6 +2,7 @@
  * OpenAPI 응답 생성 모듈
  */
 import { generateOpenApiSpec } from './openapiSpec.js';
+import { generateFullOpenApiSpec } from './openapiFullSpec.js';
 import { jsonToYaml } from './openapiYaml.js';
 /**
  * OpenAPI 스펙 응답 생성 (JSON)
@@ -30,3 +31,30 @@ export function createOpenApiYamlResponse(baseUrl) {
         },
     });
 }
+/**
+ * 전체 OpenAPI 스펙 응답 생성 (JSON)
+ */
+export function createFullOpenApiJsonResponse(baseUrl) {
+    const spec = generateFullOpenApiSpec(baseUrl);
+    return new Response(JSON.stringify(spec, null, 2), {
+        headers: {
+            'Content-Type': 'application/json; charset=utf-8',
+            'Cache-Control': 'public, max-age=3600',
+            'Access-Control-Allow-Origin': '*',
+        },
+    });
+}
+/**
+ * 전체 OpenAPI 스펙 응답 생성 (YAML)
+ */
+export function createFullOpenApiYamlResponse(baseUrl) {
+    const spec = generateFullOpenApiSpec(baseUrl);
+    const yaml = jsonToYaml(spec);
+    return new Response(yaml, {
+        headers: {
+            'Content-Type': 'text/yaml; charset=utf-8',
+            'Cache-Control': 'public, max-age=3600',
+            'Access-Control-Allow-Origin': '*',
+        },
+    });
+}

package/dist/pages/openapiSpec.js

@@ -1,43 +1,4 @@
 /**
- * OpenAPI 스펙 조합 모듈
+ * OpenAI Actions용 기본 OpenAPI 스펙 엔트리
  */
-import { OPENAPI_PATHS_DAISO_OLIVEYOUNG } from './openapiSpecPathsDaisoOliveyoung.js';
-import { OPENAPI_PATHS_MEGABOX } from './openapiSpecPathsMegabox.js';
-import { OPENAPI_PATHS_CGV } from './openapiSpecPathsCgv.js';
-import { OPENAPI_COMPONENTS } from './openapiSpecComponents.js';
-/**
- * OpenAPI 스펙 생성
- */
-export function generateOpenApiSpec(baseUrl) {
-    return {
-        openapi: '3.1.0',
-        info: {
-            title: '다이소 MCP API',
-            description: `다이소 제품 검색, 매장 찾기, 재고 확인을 위한 API입니다.
-
-## 주요 기능
-- 🔍 **제품 검색**: 키워드로 다이소 제품 검색
-- 🏪 **매장 찾기**: 지역/키워드로 매장 검색
-- 📦 **재고 확인**: 온라인 및 오프라인 매장 재고 조회
-- 🎬 **메가박스 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
-- 🎥 **CGV 지점/영화 조회**: 극장 목록, 영화 목록, 시간표 조회
-
-## 사용 팁
-1. 한글 검색어는 URL 인코딩이 자동 처리됩니다
-2. 재고 확인 시 먼저 제품 검색으로 제품 ID를 확인하세요
-3. 위치 기반 재고 조회 시 lat, lng 파라미터를 활용하세요`,
-            version: '1.0.0',
-            contact: {
-                name: 'GitHub Repository',
-                url: 'https://github.com/hmmhmmhm/daiso-mcp',
-            },
-        },
-        servers: [{ url: baseUrl, description: 'Production Server' }],
-        paths: {
-            ...OPENAPI_PATHS_DAISO_OLIVEYOUNG,
-            ...OPENAPI_PATHS_MEGABOX,
-            ...OPENAPI_PATHS_CGV,
-        },
-        components: OPENAPI_COMPONENTS,
-    };
-}
+export { generateOpenApiSpec } from './openapiSpecActions.js';

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 파라미터', 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: '매장 코드', schema: { type: 'string' } },
+    { name: 'storeName', in: 'query', required: false, description: '매장명', 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,
+    };
+}