daiso 1.0.5 → 1.0.7

package/dist/services/seveneleven/tools/searchProducts.js

@@ -3,6 +3,12 @@
  */
 import * as z from 'zod';
 import { searchSevenElevenProductsWithVariants } from '../productKeyword.js';
+function buildTextResponse(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
 async function searchProducts(args) {
     const { query, page = 1, size = 20, sort = 'recommend', timeoutMs = 15000 } = args;
     if (!query || query.trim().length === 0) {
@@ -14,25 +20,29 @@ async function searchProducts(args) {
         sort,
         timeout: timeoutMs,
     });
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    query: result.query,
-                    page,
-                    size,
-                    sort,
-                    totalCount: result.totalCount,
-                    count: result.products.length,
-                    collectionIds: result.collectionIds,
-                    appliedQueries: result.appliedQueries,
-                    products: result.products,
-                }, null, 2),
-            },
-        ],
-    };
+    return buildTextResponse({
+        query: result.query,
+        page,
+        size,
+        sort,
+        totalCount: result.totalCount,
+        count: result.products.length,
+        collectionIds: result.collectionIds,
+        appliedQueries: result.appliedQueries,
+        products: result.products,
+    });
 }
+const searchProductsOutputSchema = {
+    query: z.string().describe('적용된 검색어'),
+    page: z.number().describe('페이지 번호'),
+    size: z.number().describe('페이지 크기'),
+    sort: z.string().describe('정렬 기준'),
+    totalCount: z.number().describe('검색된 전체 상품 수'),
+    count: z.number().describe('반환된 상품 수'),
+    collectionIds: z.array(z.string()).describe('검색 컬렉션 ID 목록'),
+    appliedQueries: z.array(z.string()).describe('실제로 시도한 검색어 목록'),
+    products: z.array(z.unknown()).describe('세븐일레븐 상품 검색 결과'),
+};
 export function createSearchProductsTool() {
     return {
         name: 'seveneleven_search_products',
@@ -50,6 +60,7 @@ export function createSearchProductsTool() {
                     .describe('정렬 기준 (기본값: recommend)'),
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
+            outputSchema: searchProductsOutputSchema,
         },
         handler: searchProducts,
     };

package/dist/utils/http.js

@@ -20,18 +20,90 @@ export function createTimeoutController(timeout) {
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     return { controller, timeoutId };
 }
-export async function fetchWithTimeout(url, options = {}) {
-    const { timeout = 10000, ...restOptions } = options;
-    const { controller, timeoutId } = createTimeoutController(timeout);
-    try {
-        return await fetch(url, {
-            ...restOptions,
-            signal: controller.signal,
-        });
+const DEFAULT_RETRY_STATUS_CODES = [408, 429, 500, 502, 503, 504, 522, 524];
+const DEFAULT_RETRY_METHODS = ['GET', 'HEAD', 'OPTIONS'];
+function isRetryableStatus(status, retryStatusCodes) {
+    return retryStatusCodes.includes(status);
+}
+function wait(ms) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function normalizeMethod(method) {
+    return (method || 'GET').toUpperCase();
+}
+function canRetryMethod(method, retryMethods, retryUnsafeMethods) {
+    return retryUnsafeMethods || retryMethods.map((item) => item.toUpperCase()).includes(method);
+}
+function parseRetryAfterDelayMs(response) {
+    const retryAfter = response.headers.get('retry-after');
+    if (!retryAfter) {
+        return null;
+    }
+    const seconds = Number.parseFloat(retryAfter);
+    if (Number.isFinite(seconds)) {
+        return Math.max(0, Math.trunc(seconds * 1000));
+    }
+    const retryDate = Date.parse(retryAfter);
+    if (Number.isFinite(retryDate)) {
+        return Math.max(0, retryDate - Date.now());
     }
-    finally {
-        clearTimeout(timeoutId);
+    return null;
+}
+export async function fetchWithTimeout(url, options = {}) {
+    const { timeout = 10000, retries = 0, retryDelayMs = 250, retryStatusCodes = DEFAULT_RETRY_STATUS_CODES, retryUnsafeMethods = false, retryMethods = DEFAULT_RETRY_METHODS, onRetry, ...restOptions } = options;
+    const maxAttempts = Math.max(1, Math.trunc(retries) + 1);
+    const method = normalizeMethod(restOptions.method);
+    const retryAllowed = canRetryMethod(method, retryMethods, retryUnsafeMethods);
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const { controller, timeoutId } = createTimeoutController(timeout);
+        try {
+            const response = await fetch(url, {
+                ...restOptions,
+                signal: controller.signal,
+            });
+            if (retryAllowed && attempt < maxAttempts && isRetryableStatus(response.status, retryStatusCodes)) {
+                const delayMs = parseRetryAfterDelayMs(response) ?? retryDelayMs;
+                onRetry?.({
+                    attempt,
+                    maxAttempts,
+                    delayMs,
+                    reason: 'status',
+                    status: response.status,
+                    method,
+                    url,
+                });
+                await response.body?.cancel();
+                await wait(delayMs);
+                continue;
+            }
+            return response;
+        }
+        catch (error) {
+            if (!retryAllowed || attempt >= maxAttempts) {
+                throw error;
+            }
+            onRetry?.({
+                attempt,
+                maxAttempts,
+                delayMs: retryDelayMs,
+                reason: 'error',
+                error,
+                method,
+                url,
+            });
+            await wait(retryDelayMs);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
     }
+    /* v8 ignore next */
+    throw new Error('API 요청 재시도 처리 중 알 수 없는 오류가 발생했습니다.');
 }
 export async function fetchJson(url, options = {}) {
     const response = await fetchWithTimeout(url, options);

package/dist/utils/zyte.js

@@ -37,36 +37,84 @@ export function decodeBase64(value) {
     /* c8 ignore end */
     throw new Error('Base64 디코딩을 지원하지 않는 런타임입니다.');
 }
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+class RetryableZyteError extends Error {
+}
+function isRetryableZyteStatus(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+function isRetryableTargetStatus(statusCode) {
+    return typeof statusCode === 'number' && statusCode >= 500;
+}
+function isRetryableError(error) {
+    return isAbortError(error) || error instanceof RetryableZyteError;
+}
+function wait(ms) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
 export async function requestByZyte(options) {
-    const { timeout = 15000, url, method = 'GET', headers = [], bodyText, apiKey } = options;
+    const { timeout = 15000, retries = 1, retryDelayMs = 250, url, method = 'GET', headers = [], bodyText, apiKey, } = options;
     const auth = encodeBasicAuth(resolveZyteApiKey(apiKey));
-    const { controller, timeoutId } = createTimeoutController(timeout);
-    try {
-        const response = await fetch('https://api.zyte.com/v1/extract', {
-            method: 'POST',
-            headers: {
-                Authorization: `Basic ${auth}`,
-                'Content-Type': 'application/json',
-                Accept: 'application/json',
-            },
-            body: JSON.stringify({
-                url,
-                httpRequestMethod: method,
-                customHttpRequestHeaders: headers,
-                httpRequestText: bodyText,
-                httpResponseBody: true,
-            }),
-            signal: controller.signal,
-        });
-        const result = (await response.json());
-        if (!response.ok) {
-            throw new Error(`Zyte API 호출 실패: ${response.status} ${result.detail || result.title || ''}`.trim());
+    const maxAttempts = Math.max(1, Math.trunc(retries) + 1);
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const { controller, timeoutId } = createTimeoutController(timeout);
+        try {
+            let response;
+            try {
+                response = await fetch('https://api.zyte.com/v1/extract', {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Basic ${auth}`,
+                        'Content-Type': 'application/json',
+                        Accept: 'application/json',
+                    },
+                    body: JSON.stringify({
+                        url,
+                        httpRequestMethod: method,
+                        customHttpRequestHeaders: headers,
+                        httpRequestText: bodyText,
+                        httpResponseBody: true,
+                    }),
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                if (error instanceof TypeError) {
+                    throw new RetryableZyteError(error.message);
+                }
+                throw error;
+            }
+            const result = (await response.json());
+            if (!response.ok) {
+                const message = `Zyte API 호출 실패: ${response.status} ${result.detail || result.title || ''}`.trim();
+                if (isRetryableZyteStatus(response.status)) {
+                    throw new RetryableZyteError(message);
+                }
+                throw new Error(message);
+            }
+            if (isRetryableTargetStatus(result.statusCode) && attempt < maxAttempts) {
+                throw new RetryableZyteError(`Zyte target response failed: ${result.statusCode}`);
+            }
+            return result;
+        }
+        catch (error) {
+            if (!isRetryableError(error) || attempt >= maxAttempts) {
+                throw error;
+            }
+            await wait(retryDelayMs);
+        }
+        finally {
+            clearTimeout(timeoutId);
         }
-        return result;
-    }
-    finally {
-        clearTimeout(timeoutId);
     }
+    throw new Error('Zyte API 호출 실패');
 }
 export function decodeZyteHttpBody(result) {
     if (!result.httpResponseBody) {

package/openapi.json

@@ -53,6 +53,7 @@
                 "sevenelevenCheckInventory",
                 "sevenelevenGetPopwords",
                 "sevenelevenGetCatalog",
+                "placesSearchNearby",
                 "megaboxFindTheaters",
                 "megaboxListMovies",
                 "megaboxGetSeats",
@@ -96,7 +97,7 @@
             "name": "productId",
             "in": "query",
             "required": false,
-            "description": "제품 ID 또는 상세 조회용 path 파라미터",
+            "description": "제품 ID 또는 상세 조회용 path 파라미터. 상품명만 알면 먼저 daisoSearchProducts 또는 /api/daiso/products로 productId를 확인하세요.",
             "schema": {
               "type": "string"
             }
@@ -110,6 +111,24 @@
               "type": "string"
             }
           },
+          {
+            "name": "location",
+            "in": "query",
+            "required": false,
+            "description": "주변 장소 검색 지역/역/주소 키워드",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "category",
+            "in": "query",
+            "required": false,
+            "description": "주변 장소 카테고리(restaurant, cafe, food, dessert, all)",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "sido",
             "in": "query",
@@ -278,7 +297,7 @@
             "name": "storeCode",
             "in": "query",
             "required": false,
-            "description": "매장 코드",
+            "description": "매장 코드. 다이소 진열 위치는 /api/daiso/inventory 응답의 storeInventory.stores[].storeCode에서 확인하세요.",
             "schema": {
               "type": "string"
             }
@@ -287,7 +306,7 @@
             "name": "storeName",
             "in": "query",
             "required": false,
-            "description": "매장명",
+            "description": "매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.",
             "schema": {
               "type": "string"
             }

package/openapi.yaml

@@ -54,6 +54,7 @@ paths:
               - sevenelevenCheckInventory
               - sevenelevenGetPopwords
               - sevenelevenGetCatalog
+              - placesSearchNearby
               - megaboxFindTheaters
               - megaboxListMovies
               - megaboxGetSeats
@@ -84,7 +85,7 @@ paths:
         - name: productId
           in: query
           required: false
-          description: 제품 ID 또는 상세 조회용 path 파라미터
+          description: 제품 ID 또는 상세 조회용 path 파라미터. 상품명만 알면 먼저 daisoSearchProducts 또는 /api/daiso/products로 productId를 확인하세요.
           schema:
             type: string
         - name: keyword
@@ -93,6 +94,18 @@ paths:
           description: 공통 키워드 파라미터
           schema:
             type: string
+        - name: location
+          in: query
+          required: false
+          description: 주변 장소 검색 지역/역/주소 키워드
+          schema:
+            type: string
+        - name: category
+          in: query
+          required: false
+          description: 주변 장소 카테고리(restaurant, cafe, food, dessert, all)
+          schema:
+            type: string
         - name: sido
           in: query
           required: false
@@ -206,13 +219,13 @@ paths:
         - name: storeCode
           in: query
           required: false
-          description: 매장 코드
+          description: 매장 코드. 다이소 진열 위치는 /api/daiso/inventory 응답의 storeInventory.stores[].storeCode에서 확인하세요.
           schema:
             type: string
         - name: storeName
           in: query
           required: false
-          description: 매장명
+          description: 매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.
           schema:
             type: string
         - name: storeKeyword

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "daiso",
-  "version": "1.0.5",
-  "description": "Daiso MCP Server for mobile access via Cloudflare Workers",
+  "version": "1.0.7",
+  "description": "Korean retail and cinema MCP server, CLI, and Codex Skill for Daiso, convenience stores, marts, Olive Young, and theaters",
   "main": "dist/index.js",
   "bin": {
     "daiso": "dist/bin.js"
@@ -21,10 +21,11 @@
     "hooks:install": "git config core.hooksPath .githooks && chmod +x .githooks/pre-push",
     "dev": "wrangler dev",
     "deploy": "wrangler deploy",
-    "build": "tsc && npx tsx scripts/generate-openapi.ts",
-    "build:openapi": "npx tsx scripts/generate-openapi.ts",
-    "cli:smoke": "npm run build && npx tsx scripts/cli-smoke.ts",
-    "update:workers-chart": "npx tsx scripts/update-workers-invocations-chart.ts",
+    "build": "tsc && npx tsx scripts/ops/generate-openapi.ts",
+    "build:openapi": "npx tsx scripts/ops/generate-openapi.ts",
+    "cli:smoke": "npm run build && npx tsx scripts/ops/cli-smoke.ts",
+    "mcp:smoke": "npx tsx scripts/ops/mcp-smoke.ts",
+    "update:workers-chart": "npx tsx scripts/ops/update-workers-invocations-chart.ts",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check && npm run build",
     "release:dry-run": "npm pack --dry-run",
@@ -42,7 +43,24 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "daiso",
+    "korea",
+    "korean-retail",
+    "retail",
+    "inventory",
+    "cli",
+    "codex-skill",
+    "clawhub",
+    "oliveyoung",
+    "gs25",
+    "cu",
+    "seveneleven",
+    "emart24",
+    "lottemart",
+    "cgv",
+    "megabox",
+    "lottecinema",
     "cloudflare-workers",
     "serverless"
   ],
@@ -50,14 +68,14 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hmmhmmhm/daiso-mcp.git"
+    "url": "git+https://github.com/hmmhmmhm/daiso-mcp.git"
   },
   "homepage": "https://github.com/hmmhmmhm/daiso-mcp#readme",
   "bugs": {
     "url": "https://github.com/hmmhmmhm/daiso-mcp/issues"
   },
   "engines": {
-    "node": ">=20 <21"
+    "node": ">=20"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260316.1",
@@ -82,7 +100,8 @@
   "overrides": {
     "flatted": "3.4.2",
     "undici": "7.24.0",
-    "brace-expansion": "5.0.6"
+    "brace-expansion": "5.0.6",
+    "ws": "8.20.1"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",