daiso 1.2.2 → 1.2.4

package/README.md

@@ -85,11 +85,11 @@
 **[실시간 서비스 상태 보기](https://aka-page.betteruptime.com/)**
 
 <!-- WORKERS_INVOCATIONS_CHART:START -->
-<h3>Cloudflare 요청 수 (2026-08-20 ~ 2026-09-18, 30일)</h3>
+<h3>Cloudflare 요청 수 (2026-08-29 ~ 2026-09-27, 30일)</h3>
 
-<img src="./assets/analytics/workers-invocations.png?v=2026-09-18T18:31:45.449Z" alt="Cloudflare 요청 수 그래프 (2026-08-20 ~ 2026-09-18)" width="100%">
+<img src="./assets/analytics/workers-invocations.png?v=2026-09-27T19:00:02.076Z" alt="Cloudflare 요청 수 그래프 (2026-08-29 ~ 2026-09-27)" width="100%">
 
-<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-09-19 03:31 KST</sub>
+<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-09-28 04:00 KST</sub>
 <br><sub>집계: Worker 실행 + 루트 GET 리디렉션 요청 · 사용자 수와 다릅니다.</sub>
 
 </div>

package/dist/api/handlers.js

@@ -6,7 +6,8 @@
  */
 import { enrichOliveyoungProductsWithNearbyStoreInventory, fetchOliveyoungProducts, fetchOliveyoungStores, } from '../services/oliveyoung/client.js';
 import { fetchCuStock, fetchCuStores, geocodeCuAddress } from '../services/cu/client.js';
-import { errorResponse, successResponse } from './response.js';
+import { ServiceError } from '../core/errors.js';
+import { errorResponse, serviceErrorResponse, successResponse } from './response.js';
 export { handleCheckInventory, handleFindStores, handleGetDisplayLocation, handleGetProduct, handleSearchProducts, } from './daisoHandlers.js';
 function parseBooleanQuery(value, defaultValue = false) {
     if (!value) {
@@ -59,6 +60,8 @@ export async function handleOliveyoungSearchProducts(c) {
         }, { total: result.totalCount, page, pageSize: size });
     }
     catch (error) {
+        if (error instanceof ServiceError)
+            return serviceErrorResponse(c, error, 'product_search');
         const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
         return errorResponse(c, 'OLIVEYOUNG_PRODUCT_SEARCH_FAILED', message, 500);
     }
@@ -93,6 +96,8 @@ export async function handleOliveyoungFindStores(c) {
         }, { total: result.totalCount, page: pageIdx, pageSize: limit });
     }
     catch (error) {
+        if (error instanceof ServiceError)
+            return serviceErrorResponse(c, error, 'store_search');
         const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
         return errorResponse(c, 'OLIVEYOUNG_STORE_SEARCH_FAILED', message, 500);
     }
@@ -178,6 +183,8 @@ export async function handleOliveyoungCheckInventory(c) {
         }, { total: productResult.totalCount, page, pageSize: size });
     }
     catch (error) {
+        if (error instanceof ServiceError)
+            return serviceErrorResponse(c, error, 'inventory_check');
         const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
         return errorResponse(c, 'OLIVEYOUNG_INVENTORY_CHECK_FAILED', message, 500);
     }

package/dist/api/response.js

@@ -1,7 +1,7 @@
 /**
  * API 공통 응답 유틸리티
  */
-import { toStandardErrorDiagnostics } from '../core/errors.js';
+import { toServiceErrorDiagnostics, toStandardErrorDiagnostics } from '../core/errors.js';
 /**
  * 성공 응답 생성
  */
@@ -22,3 +22,11 @@ export function errorResponse(c, code, message, status = 400) {
         diagnostics: toStandardErrorDiagnostics(code, message, { status }),
     }, status);
 }
+/** 원문이 제거된 외부 서비스 오류를 실제 상태와 함께 반환합니다. */
+export function serviceErrorResponse(c, error, operation) {
+    return c.json({
+        success: false,
+        error: { code: error.code, message: error.message },
+        diagnostics: toServiceErrorDiagnostics(error, operation),
+    }, error.status);
+}

package/dist/core/errors.js

@@ -2,6 +2,21 @@
  * MCP/API 공통 에러 진단 구조
  */
 export const ZYTE_COST_POLICY_MESSAGE = 'Zyte 유료 호출은 비용 정책에 따라 비활성화되어 있습니다.';
+/** 외부 응답 원문 없이 API와 MCP에 전달할 오류 진단입니다. */
+export class ServiceError extends Error {
+    code;
+    status;
+    retryable;
+    upstreamStatus;
+    constructor(code, message, status, retryable, upstreamStatus) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.retryable = retryable;
+        this.upstreamStatus = upstreamStatus;
+        this.name = 'ServiceError';
+    }
+}
 const SERVICE_PREFIXES = [
     'daiso',
     'gs25',
@@ -92,3 +107,15 @@ export function toStandardErrorDiagnostics(code, message, options = {}) {
 export function getErrorMessage(error) {
     return error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
 }
+/** 전송 계층에서 확인한 재시도 가능 여부를 공통 진단에도 유지합니다. */
+export function toServiceErrorDiagnostics(error, operation) {
+    return {
+        ...toStandardErrorDiagnostics(error.code, error.message, {
+            status: error.status,
+            upstreamStatus: error.upstreamStatus,
+            operation,
+        }),
+        retryable: error.retryable,
+        hint: buildHint(error.retryable),
+    };
+}

package/dist/core/registry.js

@@ -3,7 +3,7 @@
  *
  * 서비스 프로바이더를 등록하고 MCP 서버에 도구를 연결합니다.
  */
-import { getErrorMessage } from './errors.js';
+import { getErrorMessage, ServiceError, toServiceErrorDiagnostics } from './errors.js';
 import { createToolOutputSchema } from './outputSchema.js';
 function parseJsonText(text) {
     try {
@@ -177,7 +177,12 @@ export class ServiceRegistry {
                 result = await tool.handler(args);
             }
             catch (error) {
-                const message = getErrorMessage(error);
+                const message = error instanceof ServiceError
+                    ? JSON.stringify({
+                        error: { code: error.code, message: error.message },
+                        diagnostics: toServiceErrorDiagnostics(error, tool.name.replace(/^[^_]+_/, '')),
+                    })
+                    : getErrorMessage(error);
                 return {
                     isError: true,
                     content: [{ type: 'text', text: message }],

package/dist/services/cgv/transport.js

@@ -46,6 +46,8 @@ export async function requestCgv(path, searchParams, timeout = 15000, _zyteApiKe
             headers: {
                 Accept: 'application/json',
                 'Accept-Language': 'ko-KR',
+                // 기본 fetch User-Agent는 CGV 앞단에서 403으로 차단된다.
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36',
                 'X-TIMESTAMP': timestamp,
                 'X-SIGNATURE': signature,
             },

package/dist/services/cu/client.js

@@ -12,6 +12,8 @@ const CU_DEFAULT_HEADERS = {
     'User-Agent': 'Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/138.0.0.0 Mobile Safari/537.36;BGFCU',
 };
 const CU_WEB_DEFAULT_HEADERS = {
+    // Workers의 기본 요청에는 User-Agent가 없어 공식 웹이 400을 반환합니다.
+    'User-Agent': 'Mozilla/5.0',
     'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
     'X-Requested-With': 'XMLHttpRequest',
     Accept: 'text/html, */*; q=0.01',

package/dist/services/dtryx/api.js

@@ -5,7 +5,11 @@
  * 공개 조회 엔드포인트이며 별도 인증 키가 필요하지 않습니다.
  */
 export const DTRYX_API = {
-    BASE_URL: 'https://api.dtryx.com:30443',
+    /**
+     * 두 포트의 공개 조회 응답이 동일함을 확인해 표준 HTTPS 포트를 사용합니다.
+     * Worker의 간헐 연결 실패는 양쪽 포트에서 관측되어 별도로 추적합니다(#187).
+     */
+    BASE_URL: 'https://api.dtryx.com',
     THIRDPARTY_PATH: '/dtryx/cms/thirdparty/movie',
     CHANNEL_CODE: 'homepage',
     ENDPOINTS: {

package/dist/services/oliveyoung/client.js

@@ -205,48 +205,53 @@ function sortOliveyoungProducts(products) {
     return [...products].sort((left, right) => score(right) - score(left));
 }
 export async function enrichOliveyoungProductsWithNearbyStoreInventory(products, params, options = {}) {
-    const maxProducts = Math.max(0, Math.min(products.length, params.maxProducts));
+    const requestedLimit = Number.isFinite(params.maxProducts) ? Math.floor(params.maxProducts) : 5;
+    const maxProducts = Math.max(0, Math.min(products.length, requestedLimit, 5));
     if (maxProducts === 0) {
         return { checkedCount: 0, products };
     }
-    const checkedProducts = await Promise.all(products.slice(0, maxProducts).map(async (product) => {
-        let productId = '';
-        try {
-            productId = await fetchOliveyoungProductId(product.goodsNumber, options);
-        }
-        catch {
-            return { checked: false, product };
-        }
-        if (!productId) {
-            return { checked: false, product };
-        }
-        let storeInventory;
-        try {
-            storeInventory = await fetchOliveyoungStockStores({
-                productId,
-                latitude: params.latitude,
-                longitude: params.longitude,
-                pageIdx: 1,
-                searchWords: params.storeKeyword,
-            }, options);
-        }
-        catch {
-            return { checked: false, product };
-        }
-        const inStock = storeInventory.inStockCount > 0;
-        const stockStatus = inStock ? 'in_stock' : 'out_of_stock';
-        const stockSource = 'nearby_store';
-        return {
-            checked: true,
-            product: {
-                ...product,
-                inStock,
-                stockStatus,
-                stockSource,
-                storeInventory,
-            },
-        };
-    }));
+    const checkedProducts = [];
+    // 릴레이 슬롯을 한 요청이 독점하지 않도록 상품 보강을 2개씩 실행합니다.
+    for (let start = 0; start < maxProducts; start += 2) {
+        checkedProducts.push(...await Promise.all(products.slice(start, Math.min(start + 2, maxProducts)).map(async (product) => {
+            let productId = '';
+            try {
+                productId = await fetchOliveyoungProductId(product.goodsNumber, options);
+            }
+            catch {
+                return { checked: false, product };
+            }
+            if (!productId) {
+                return { checked: false, product };
+            }
+            let storeInventory;
+            try {
+                storeInventory = await fetchOliveyoungStockStores({
+                    productId,
+                    latitude: params.latitude,
+                    longitude: params.longitude,
+                    pageIdx: 1,
+                    searchWords: params.storeKeyword,
+                }, options);
+            }
+            catch {
+                return { checked: false, product };
+            }
+            const inStock = storeInventory.inStockCount > 0;
+            const stockStatus = inStock ? 'in_stock' : 'out_of_stock';
+            const stockSource = 'nearby_store';
+            return {
+                checked: true,
+                product: {
+                    ...product,
+                    inStock,
+                    stockStatus,
+                    stockSource,
+                    storeInventory,
+                },
+            };
+        })));
+    }
     const enrichedProducts = [
         ...checkedProducts.map((result) => result.product),
         ...products.slice(maxProducts),

package/dist/services/oliveyoung/errors.js

@@ -0,0 +1,15 @@
+/** 릴레이 원문과 자격증명을 보존하지 않는 안전한 오류 분류. */
+import { ServiceError } from '../../core/errors.js';
+import { HttpError, UnexpectedHtmlResponseError } from '../../utils/http.js';
+export function toOliveyoungRelayError(error) {
+    if (error instanceof HttpError) {
+        return new ServiceError('OLIVEYOUNG_RELAY_HTTP_ERROR', `올리브영 브라우저 릴레이 요청 실패 (HTTP ${error.status})`, [429, 502, 503].includes(error.status) ? error.status : 502, error.status >= 500 || error.status === 408 || error.status === 429, error.status);
+    }
+    if (error instanceof Error && ['AbortError', 'TimeoutError'].includes(error.name)) {
+        return new ServiceError('OLIVEYOUNG_RELAY_TIMEOUT', '올리브영 브라우저 릴레이 요청 시간 초과', 504, true);
+    }
+    if (error instanceof SyntaxError || error instanceof UnexpectedHtmlResponseError) {
+        return new ServiceError('OLIVEYOUNG_RELAY_INVALID_RESPONSE', '올리브영 브라우저 릴레이 응답 형식 오류', 502, false);
+    }
+    return new ServiceError('OLIVEYOUNG_RELAY_NETWORK_ERROR', '올리브영 브라우저 릴레이 네트워크 요청 실패', 502, true);
+}

package/dist/services/oliveyoung/tools/checkInventory.js

@@ -97,7 +97,7 @@ export function createCheckInventoryTool(apiKey, transport = {}) {
                     .number()
                     .optional()
                     .default(5)
-                    .describe('주변 매장별 재고를 보강할 상품 수 (기본값: 5, 낮출수록 빠름)'),
+                    .describe('주변 매장별 재고를 보강할 상품 수 (기본값: 5, 최대: 5, 낮출수록 빠름)'),
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },

package/dist/services/oliveyoung/transport.js

@@ -1,5 +1,6 @@
 /** 올리브영 무료 직접 요청 및 운영자가 설정한 브라우저 릴레이 전송. */
 import { fetchJson } from '../../utils/http.js';
+import { toOliveyoungRelayError } from './errors.js';
 import { OLIVEYOUNG_API } from './api.js';
 /** 설정 진단과 실제 요청에 같은 릴레이 URL 규칙을 적용합니다. */
 export function isValidOliveyoungRelayUrl(value) {
@@ -44,11 +45,20 @@ export async function requestOliveyoung(path, body, options = {}) {
             headers['CF-Access-Client-Secret'] = accessClientSecret;
         }
     }
+    else {
+        // 공식 사이트 직접 조회용 헤더는 운영자 릴레이에 전달하지 않습니다.
+        headers['User-Agent'] =
+            'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36';
+        headers.Origin = OLIVEYOUNG_API.BASE_URL;
+        headers.Referer = `${OLIVEYOUNG_API.BASE_URL}/`;
+        headers['Accept-Language'] = 'ko-KR,ko;q=0.9';
+    }
     let result;
     try {
         result = await fetchJson(url, {
             method: 'POST',
-            redirect: 'error',
+            // Workers는 error 모드를 지원하지 않으므로 따라가지 않고 아래 200 검사로 거절합니다.
+            redirect: 'manual',
             headers,
             body: JSON.stringify(body),
             timeout,
@@ -57,14 +67,16 @@ export async function requestOliveyoung(path, body, options = {}) {
         });
     }
     catch (error) {
+        if (relayUrl)
+            throw toOliveyoungRelayError(error);
         if (error instanceof Error && error.name === 'AbortError') {
             throw new Error('올리브영 API 요청 시간 초과');
         }
-        if (relayUrl)
-            throw new Error('올리브영 브라우저 릴레이 요청 실패');
         throw new Error('올리브영 직접 요청 실패. 운영자는 OY_RELAY_URL과 OY_RELAY_TOKEN으로 브라우저 릴레이를 설정해주세요.', { cause: error });
     }
     if (result?.status !== 'SUCCESS') {
+        if (relayUrl)
+            throw toOliveyoungRelayError(new SyntaxError());
         throw new Error(`올리브영 API 상태 오류: ${result?.status || 'UNKNOWN'}`);
     }
     return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "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": {