daiso 1.0.9 → 1.1.0

package/dist/services/lottemart/session.js

@@ -4,7 +4,10 @@
 import { HttpError, fetchWithTimeout } from '../../utils/http.js';
 import { decodeBase64, requestByZyte } from '../../utils/zyte.js';
 import { LOTTEMART_API } from './api.js';
+import { fetchLotteMartSocketResponse, toLotteMartBodyText, withLotteMartSessionCookie, } from './socketTransport.js';
+export { __testOnlyCreateLotteMartSocketResponse, __testOnlyFetchLotteMartSocketResponse, withLotteMartSessionCookie, } from './socketTransport.js';
 const SESSION_CACHE_TTL_MS = 5 * 60 * 1000;
+const FALLBACK_TIMEOUT_MS = 5000;
 let sessionCache = null;
 function extractSessionCookie(response) {
     const cookieHeaders = response.headers;
@@ -17,135 +20,6 @@ function extractSessionCookie(response) {
         .find((value) => value.startsWith('ASPSESSIONID'));
     return matched ? matched.split(';')[0].trim() : '';
 }
-function withSocketTimeout(operation, timeout) {
-    const timeoutMs = Math.max(1, Math.trunc(timeout));
-    return new Promise((resolve, reject) => {
-        const timeoutId = setTimeout(() => resolve(null), timeoutMs);
-        operation.then((value) => {
-            clearTimeout(timeoutId);
-            resolve(value);
-        }, (error) => {
-            clearTimeout(timeoutId);
-            reject(error);
-        });
-    });
-}
-export function __testOnlyCreateLotteMartSocketResponse(raw) {
-    const delimiter = new TextEncoder().encode('\r\n\r\n');
-    let boundary = -1;
-    for (let index = 0; index <= raw.length - delimiter.length; index += 1) {
-        let matched = true;
-        for (let inner = 0; inner < delimiter.length; inner += 1) {
-            if (raw[index + inner] !== delimiter[inner]) {
-                matched = false;
-                break;
-            }
-        }
-        if (matched) {
-            boundary = index;
-            break;
-        }
-    }
-    if (boundary < 0) {
-        return null;
-    }
-    const headerText = new TextDecoder().decode(raw.slice(0, boundary));
-    if (!headerText.startsWith('HTTP/')) {
-        return null;
-    }
-    const bodyBytes = raw.slice(boundary + delimiter.length);
-    const headerLinesRaw = headerText.split('\r\n');
-    const statusLine = headerLinesRaw.shift();
-    const [, statusCodeText = '500', ...statusTextParts] = statusLine.split(' ');
-    const responseHeaders = new Headers();
-    for (const line of headerLinesRaw) {
-        const separatorIndex = line.indexOf(':');
-        if (separatorIndex < 0) {
-            continue;
-        }
-        responseHeaders.append(line.slice(0, separatorIndex).trim(), line.slice(separatorIndex + 1).trim());
-    }
-    return new Response(bodyBytes, {
-        status: parseInt(statusCodeText, 10) || 500,
-        statusText: statusTextParts.join(' ').trim(),
-        headers: responseHeaders,
-    });
-}
-export async function __testOnlyFetchLotteMartSocketResponse(url, init, sessionCookie, connectFn, timeout) {
-    const requestUrl = new URL(url);
-    const headers = withLotteMartSessionCookie({
-        Accept: 'text/html, */*; q=0.01',
-        Host: LOTTEMART_API.ORIGIN_HOST,
-        Origin: 'https://company.lottemart.com',
-        Referer: LOTTEMART_API.ORIGIN_REFERER,
-        Connection: 'close',
-        ...init.headers,
-    }, sessionCookie);
-    const bodyText = toBodyText(init.body) || '';
-    if (bodyText.length > 0 && !headers.has('Content-Length')) {
-        headers.set('Content-Length', String(new TextEncoder().encode(bodyText).length));
-    }
-    const headerLines = Array.from(headers.entries()).map(([name, value]) => `${name}: ${value}`);
-    const path = `${requestUrl.pathname}${requestUrl.search}`;
-    const requestText = [`${init.method || 'GET'} ${path} HTTP/1.1`, ...headerLines, '', bodyText].join('\r\n');
-    const socket = connectFn({
-        hostname: LOTTEMART_API.SOCKET_HOST,
-        port: 80,
-    }, { allowHalfOpen: true });
-    const writer = socket.writable.getWriter();
-    const encodedRequest = new TextEncoder().encode(requestText);
-    if ((await withSocketTimeout(writer.write(encodedRequest), timeout)) === null) {
-        void writer.abort().catch(Boolean);
-        return null;
-    }
-    if ((await withSocketTimeout(writer.close(), timeout)) === null) {
-        void writer.abort().catch(Boolean);
-        return null;
-    }
-    const reader = socket.readable.getReader();
-    const chunks = [];
-    try {
-        while (true) {
-            const readResult = await withSocketTimeout(reader.read(), timeout);
-            if (readResult === null) {
-                await reader.cancel().catch(() => undefined);
-                return null;
-            }
-            const { value, done } = readResult;
-            if (done) {
-                break;
-            }
-            chunks.push(value);
-        }
-    }
-    finally {
-        reader.releaseLock();
-    }
-    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
-    const raw = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-        raw.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return __testOnlyCreateLotteMartSocketResponse(raw);
-}
-/* c8 ignore start */
-async function fetchLotteMartSocketResponse(url, init, sessionCookie, timeout) {
-    let connectFn = null;
-    try {
-        const socketsModule = await import('cloudflare:sockets');
-        connectFn = socketsModule.connect;
-    }
-    catch {
-        return null;
-    }
-    if (!connectFn) {
-        return null;
-    }
-    return __testOnlyFetchLotteMartSocketResponse(url, init, sessionCookie, connectFn, timeout);
-}
-/* c8 ignore end */
 function cacheSessionCookie(cookie) {
     const normalized = cookie.trim();
     if (normalized.length === 0) {
@@ -173,39 +47,29 @@ export async function getCachedLotteMartSessionCookie(_timeout, forceRefresh = f
 export async function getFreshLotteMartSessionCookie(timeout) {
     return getCachedLotteMartSessionCookie(timeout, true);
 }
-export function withLotteMartSessionCookie(headers, sessionCookie) {
-    const result = new Headers(headers);
-    if (sessionCookie.trim().length > 0) {
-        result.set('Cookie', sessionCookie);
-    }
-    return result;
-}
 async function fetchLotteMartResponse(url, init, timeout, sessionCookie) {
-    const socketResponse = await fetchLotteMartSocketResponse(url, init, sessionCookie, timeout);
-    if (socketResponse) {
-        return socketResponse;
+    const headers = withLotteMartSessionCookie({
+        Accept: 'text/html, */*; q=0.01',
+        ...init.headers,
+    }, sessionCookie);
+    try {
+        return await fetchWithTimeout(url, {
+            ...init,
+            timeout,
+            headers,
+        });
+    }
+    catch (directError) {
+        const socketResponse = await fetchLotteMartSocketResponse(url, init, sessionCookie, Math.min(timeout, FALLBACK_TIMEOUT_MS)).catch(() => null);
+        if (socketResponse) {
+            return socketResponse;
+        }
+        throw directError;
     }
-    return fetchWithTimeout(url, {
-        ...init,
-        timeout,
-        headers: withLotteMartSessionCookie({
-            Accept: 'text/html, */*; q=0.01',
-            ...init.headers,
-        }, sessionCookie),
-    });
 }
 function toZyteHeaders(headers) {
     return Array.from(headers.entries()).map(([name, value]) => ({ name, value }));
 }
-function toBodyText(body) {
-    if (typeof body === 'string') {
-        return body;
-    }
-    if (body instanceof URLSearchParams) {
-        return body.toString();
-    }
-    return undefined;
-}
 async function fetchLotteMartHtmlByZyte(url, init, timeout, sessionCookie, zyteApiKey) {
     const headers = withLotteMartSessionCookie({
         Accept: 'text/html, */*; q=0.01',
@@ -217,7 +81,8 @@ async function fetchLotteMartHtmlByZyte(url, init, timeout, sessionCookie, zyteA
         timeout,
         method: init.method || 'GET',
         headers: toZyteHeaders(headers),
-        bodyText: toBodyText(init.body),
+        bodyText: toLotteMartBodyText(init.body),
+        tags: { service: 'lottemart' },
     });
     if (!result.httpResponseBody) {
         throw new Error('Zyte HTTP 응답 본문이 비어 있습니다.');
@@ -238,7 +103,9 @@ export async function probeLotteMartRequest(url, init, timeout, sessionCookie, z
             success: response.ok,
             status: response.status,
             statusText: response.statusText,
-            error: response.ok ? null : new HttpError(response.status, response.statusText, bodyText).message,
+            error: response.ok
+                ? null
+                : new HttpError(response.status, response.statusText, bodyText).message,
             bodyPreview: toBodyPreview(bodyText),
             sessionCookie: extractSessionCookie(response) || null,
         });
@@ -304,7 +171,9 @@ export async function fetchLotteMartHtml(url, init, timeout, sessionCookie, zyte
         if (!response.ok) {
             throw new HttpError(response.status, response.statusText, bodyText);
         }
-        if (bodyText.trim().length === 0 && sessionCookie.trim().length === 0 && cachedCookie.length > 0) {
+        if (bodyText.trim().length === 0 &&
+            sessionCookie.trim().length === 0 &&
+            cachedCookie.length > 0) {
             const retried = await fetchLotteMartResponse(url, init, timeout, cachedCookie);
             cacheSessionCookieFromResponse(retried);
             const retriedBodyText = await retried.text();
@@ -318,7 +187,7 @@ export async function fetchLotteMartHtml(url, init, timeout, sessionCookie, zyte
     catch (error) {
         if (zyteApiKey && error instanceof Error && !error.message.includes('Zyte')) {
             const fallbackCookie = await getCachedLotteMartSessionCookie(timeout);
-            return fetchLotteMartHtmlByZyte(url, init, timeout, fallbackCookie || sessionCookie, zyteApiKey);
+            return fetchLotteMartHtmlByZyte(url, init, Math.min(timeout, FALLBACK_TIMEOUT_MS), fallbackCookie || sessionCookie, zyteApiKey);
         }
         throw error;
     }

package/dist/services/lottemart/socketTransport.js

@@ -0,0 +1,149 @@
+/**
+ * 롯데마트 HTTP 소켓 전송
+ */
+import { LOTTEMART_API } from './api.js';
+function withSocketTimeout(operation, timeout) {
+    const timeoutMs = Math.max(1, Math.trunc(timeout));
+    return new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => resolve(null), timeoutMs);
+        operation.then((value) => {
+            clearTimeout(timeoutId);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+export function withLotteMartSessionCookie(headers, sessionCookie) {
+    const result = new Headers(headers);
+    if (sessionCookie.trim().length > 0) {
+        result.set('Cookie', sessionCookie);
+    }
+    return result;
+}
+export function toLotteMartBodyText(body) {
+    if (typeof body === 'string') {
+        return body;
+    }
+    if (body instanceof URLSearchParams) {
+        return body.toString();
+    }
+    return undefined;
+}
+export function __testOnlyCreateLotteMartSocketResponse(raw) {
+    const delimiter = new TextEncoder().encode('\r\n\r\n');
+    let boundary = -1;
+    for (let index = 0; index <= raw.length - delimiter.length; index += 1) {
+        let matched = true;
+        for (let inner = 0; inner < delimiter.length; inner += 1) {
+            if (raw[index + inner] !== delimiter[inner]) {
+                matched = false;
+                break;
+            }
+        }
+        if (matched) {
+            boundary = index;
+            break;
+        }
+    }
+    if (boundary < 0) {
+        return null;
+    }
+    const headerText = new TextDecoder().decode(raw.slice(0, boundary));
+    if (!headerText.startsWith('HTTP/')) {
+        return null;
+    }
+    const bodyBytes = raw.slice(boundary + delimiter.length);
+    const headerLinesRaw = headerText.split('\r\n');
+    const statusLine = headerLinesRaw.shift();
+    const [, statusCodeText = '500', ...statusTextParts] = statusLine.split(' ');
+    const responseHeaders = new Headers();
+    for (const line of headerLinesRaw) {
+        const separatorIndex = line.indexOf(':');
+        if (separatorIndex < 0) {
+            continue;
+        }
+        responseHeaders.append(line.slice(0, separatorIndex).trim(), line.slice(separatorIndex + 1).trim());
+    }
+    return new Response(bodyBytes, {
+        status: parseInt(statusCodeText, 10) || 500,
+        statusText: statusTextParts.join(' ').trim(),
+        headers: responseHeaders,
+    });
+}
+export async function __testOnlyFetchLotteMartSocketResponse(url, init, sessionCookie, connectFn, timeout) {
+    const requestUrl = new URL(url);
+    const headers = withLotteMartSessionCookie({
+        Accept: 'text/html, */*; q=0.01',
+        Host: LOTTEMART_API.ORIGIN_HOST,
+        Origin: 'https://company.lottemart.com',
+        Referer: LOTTEMART_API.ORIGIN_REFERER,
+        Connection: 'close',
+        ...init.headers,
+    }, sessionCookie);
+    const bodyText = toLotteMartBodyText(init.body) || '';
+    if (bodyText.length > 0 && !headers.has('Content-Length')) {
+        headers.set('Content-Length', String(new TextEncoder().encode(bodyText).length));
+    }
+    const headerLines = Array.from(headers.entries()).map(([name, value]) => `${name}: ${value}`);
+    const path = `${requestUrl.pathname}${requestUrl.search}`;
+    const requestText = [`${init.method || 'GET'} ${path} HTTP/1.1`, ...headerLines, '', bodyText].join('\r\n');
+    const socket = connectFn({
+        hostname: LOTTEMART_API.SOCKET_HOST,
+        port: 80,
+    }, { allowHalfOpen: true });
+    const writer = socket.writable.getWriter();
+    const encodedRequest = new TextEncoder().encode(requestText);
+    if ((await withSocketTimeout(writer.write(encodedRequest), timeout)) === null) {
+        void writer.abort().catch(Boolean);
+        return null;
+    }
+    if ((await withSocketTimeout(writer.close(), timeout)) === null) {
+        void writer.abort().catch(Boolean);
+        return null;
+    }
+    const reader = socket.readable.getReader();
+    const chunks = [];
+    try {
+        while (true) {
+            const readResult = await withSocketTimeout(reader.read(), timeout);
+            if (readResult === null) {
+                await reader.cancel().catch(() => undefined);
+                return null;
+            }
+            const { value, done } = readResult;
+            if (done) {
+                break;
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const raw = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        raw.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return __testOnlyCreateLotteMartSocketResponse(raw);
+}
+/* c8 ignore start */
+export async function fetchLotteMartSocketResponse(url, init, sessionCookie, timeout) {
+    let connectFn = null;
+    try {
+        const socketsModule = await import('cloudflare:sockets');
+        connectFn = socketsModule.connect;
+    }
+    catch {
+        return null;
+    }
+    if (!connectFn) {
+        return null;
+    }
+    return __testOnlyFetchLotteMartSocketResponse(url, init, sessionCookie, connectFn, timeout);
+}
+/* c8 ignore end */

package/dist/services/oliveyoung/client.js

@@ -70,6 +70,7 @@ async function zyteExtract(targetPath, requestBody, options = {}) {
                 { name: 'X-Requested-With', value: 'XMLHttpRequest' },
             ],
             bodyText: JSON.stringify(requestBody),
+            tags: { service: 'oliveyoung' },
         });
         if (result.statusCode !== 200 || !result.httpResponseBody) {
             throw new Error(`올리브영 API 응답 실패: ${result.statusCode || 'unknown'}`);

package/dist/services/places/client.js

@@ -5,22 +5,43 @@ const CATEGORY_KEYWORDS = {
     dessert: '디저트',
     all: '',
 };
+const HTML_ENTITY_REPLACEMENTS = {
+    '&': '&',
+    '"': '"',
+    ''': "'",
+    ''': "'",
+};
 function getProcessEnvValue(name) {
     /* c8 ignore next -- Node 테스트와 CLI 런타임은 process를 제공하며, Worker에는 API에서 키를 주입합니다. */
     return typeof process !== 'undefined' ? process.env[name] : undefined;
 }
+function stripHtmlTags(value) {
+    let result = '';
+    let insideTag = false;
+    for (const character of value) {
+        if (character === '<') {
+            insideTag = true;
+            continue;
+        }
+        if (character === '>' && insideTag) {
+            insideTag = false;
+            continue;
+        }
+        if (!insideTag) {
+            result += character;
+        }
+    }
+    return result;
+}
 function cleanHtml(value) {
     if (!value) {
         return '';
     }
-    return value
-        .replace(/<[^>]*>/g, '')
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
-        .trim();
+    let result = stripHtmlTags(value);
+    for (const [entity, replacement] of Object.entries(HTML_ENTITY_REPLACEMENTS)) {
+        result = result.split(entity).join(replacement);
+    }
+    return result.trim();
 }
 function toCoordinate(value) {
     if (!value) {

package/dist/services/seveneleven/client.js

@@ -2,7 +2,7 @@
  * 세븐일레븐 API 클라이언트
  */
 /* c8 ignore start */
-import { fetchJson } from '../../utils/http.js';
+import { fetchJsonWithZyteFallback } from '../../utils/zyteJsonFallback.js';
 import { SEVENELEVEN_API } from './api.js';
 const SEVENELEVEN_DEFAULT_HEADERS = {
     Accept: 'application/json, text/plain, */*',
@@ -109,15 +109,17 @@ function normalizeStores(items) {
         .filter((store) => store.storeCode.length > 0 || store.storeName.length > 0);
 }
 async function requestSevenElevenJson(path, method, body, options = {}) {
-    const { timeout = 15000 } = options;
+    const { timeout = 15000, zyteApiKey } = options;
     const url = `${SEVENELEVEN_API.BASE_URL}${path}`;
-    return fetchJson(url, {
+    return fetchJsonWithZyteFallback(url, {
         ...SEVENELEVEN_DEFAULT_FETCH_OPTIONS,
         method,
         retryUnsafeMethods: method === 'POST',
         timeout,
         headers: SEVENELEVEN_DEFAULT_HEADERS,
         body: method === 'POST' ? JSON.stringify(body || {}) : undefined,
+        zyteApiKey,
+        zyteTags: { service: 'seveneleven' },
     });
 }
 export async function searchSevenElevenProducts(params, options = {}) {
@@ -216,7 +218,7 @@ export async function fetchSevenElevenStockProductMeta(itemCode, options = {}) {
     const { timeout = 15000 } = options;
     const encodedItemCode = encodeURIComponent(itemCode.trim());
     const url = `${SEVENELEVEN_API.BASE_URL}${SEVENELEVEN_API.PRODUCT_SEARCH_STOCK_PATH}?itemCd=${encodedItemCode}`;
-    const response = await fetchJson(url, {
+    const response = await fetchJsonWithZyteFallback(url, {
         ...SEVENELEVEN_DEFAULT_FETCH_OPTIONS,
         method: 'GET',
         timeout,
@@ -224,6 +226,8 @@ export async function fetchSevenElevenStockProductMeta(itemCode, options = {}) {
             Accept: SEVENELEVEN_DEFAULT_HEADERS.Accept,
             'User-Agent': SEVENELEVEN_DEFAULT_HEADERS['User-Agent'],
         },
+        zyteApiKey: options.zyteApiKey,
+        zyteTags: { service: 'seveneleven' },
     });
     const productMeta = normalizeStockProductMeta(response);
     if (productMeta.itemCode.length === 0 || productMeta.smCode.length === 0) {
@@ -263,14 +267,20 @@ function extractContentArray(data) {
     return [];
 }
 export async function fetchSevenElevenCatalogSnapshot(options = {}) {
-    const { includeIssues = true, includeExhibition = true, timeout = 15000 } = options;
+    const { includeIssues = true, includeExhibition = true, timeout = 15000, zyteApiKey } = options;
     const tasks = [
-        requestSevenElevenJson(SEVENELEVEN_API.PRODUCT_PAGES_PATH, 'GET', null, { timeout }),
+        requestSevenElevenJson(SEVENELEVEN_API.PRODUCT_PAGES_PATH, 'GET', null, { timeout, zyteApiKey }),
         includeIssues
-            ? requestSevenElevenJson(SEVENELEVEN_API.PRODUCT_ISSUES_PATH, 'GET', null, { timeout })
+            ? requestSevenElevenJson(SEVENELEVEN_API.PRODUCT_ISSUES_PATH, 'GET', null, {
+                timeout,
+                zyteApiKey,
+            })
             : Promise.resolve({ data: { content: [] } }),
         includeExhibition
-            ? requestSevenElevenJson(SEVENELEVEN_API.EXHIBITION_MAIN_PATH, 'GET', null, { timeout })
+            ? requestSevenElevenJson(SEVENELEVEN_API.EXHIBITION_MAIN_PATH, 'GET', null, {
+                timeout,
+                zyteApiKey,
+            })
             : Promise.resolve({ data: [] }),
     ];
     const [pagesResult, issuesResult, exhibitionsResult] = await Promise.allSettled(tasks);

package/dist/services/seveneleven/index.js

@@ -13,18 +13,22 @@ const SEVENELEVEN_METADATA = {
     description: '세븐일레븐 공개 상품/검색/카탈로그 조회 서비스',
 };
 class SevenElevenService {
+    options;
     metadata = SEVENELEVEN_METADATA;
+    constructor(options = {}) {
+        this.options = options;
+    }
     getTools() {
         return [
-            createSearchProductsTool(),
-            createSearchStoresTool(),
-            createCheckInventoryTool(),
-            createGetSearchPopwordsTool(),
-            createGetCatalogSnapshotTool(),
+            createSearchProductsTool(this.options.zyteApiKey),
+            createSearchStoresTool(this.options.zyteApiKey),
+            createCheckInventoryTool(this.options.zyteApiKey),
+            createGetSearchPopwordsTool(this.options.zyteApiKey),
+            createGetCatalogSnapshotTool(this.options.zyteApiKey),
         ];
     }
 }
-export function createSevenElevenService() {
-    return new SevenElevenService();
+export function createSevenElevenService(options = {}) {
+    return new SevenElevenService(options);
 }
 export * from './types.js';

package/dist/services/seveneleven/inventory.js

@@ -5,7 +5,8 @@
  * 재고 API가 암호화로 차단된 경우에도 상품/매장 정보를 graceful하게 반환합니다.
  */
 /* c8 ignore start */
-import { fetchJson, HttpError } from '../../utils/http.js';
+import { HttpError } from '../../utils/http.js';
+import { fetchJsonWithZyteFallback } from '../../utils/zyteJsonFallback.js';
 import { SEVENELEVEN_API } from './api.js';
 import { fetchSevenElevenStockProductMeta, fetchSevenElevenStoresByKeyword, } from './client.js';
 import { pickBestSevenElevenProduct, searchSevenElevenProductsWithVariants } from './productKeyword.js';
@@ -180,11 +181,13 @@ async function tryStockApi(stockProduct, stores, options = {}) {
         return { stores: null, error: null };
     }
     try {
-        const response = await fetchJson(url, {
+        const response = await fetchJsonWithZyteFallback(url, {
             method: 'POST',
             timeout,
             headers: SEVENELEVEN_DEFAULT_HEADERS,
             body: JSON.stringify(payload),
+            zyteApiKey: options.zyteApiKey,
+            zyteTags: { service: 'seveneleven', operation: 'inventory' },
         });
         const responseError = normalizeEnvelopeError(response);
         if (responseError) {

package/dist/services/seveneleven/productKeyword.js

@@ -1,7 +1,7 @@
 /**
  * 세븐일레븐 상품 검색어 보정
  */
-import { searchSevenElevenProducts } from './client.js';
+import { searchSevenElevenProducts, } from './client.js';
 const SANDWICH_SUFFIX_FAMILY = ['샌드위치', '샌드', '산도'];
 function normalizeProductText(value) {
     return value.replace(/[^0-9A-Za-z가-힣]+/g, '').toLowerCase();
@@ -95,7 +95,7 @@ function scoreSevenElevenProduct(product, rawKeyword) {
  * 보정 질의를 순차 적용해 세븐일레븐 상품을 찾습니다.
  */
 export async function searchSevenElevenProductsWithVariants(query, options = {}) {
-    const { page = 1, size = 20, sort = 'recommend', timeout } = options;
+    const { page = 1, size = 20, sort = 'recommend', timeout, zyteApiKey } = options;
     const appliedQueries = buildSevenElevenProductKeywordVariants(query);
     const seenKeys = new Set();
     const collectionIds = new Set();
@@ -108,6 +108,7 @@ export async function searchSevenElevenProductsWithVariants(query, options = {})
             sort,
         }, {
             timeout,
+            zyteApiKey,
         });
         for (const collectionId of result.collectionIds) {
             collectionIds.add(collectionId);

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

@@ -16,7 +16,7 @@ function isEncryptedStockFailure(stockError) {
     const messageMatched = /RSA|복호화|암호화|서비스를 사용할 수 없습니다/i.test(messageSource);
     return codeMatched || messageMatched;
 }
-async function checkInventory(args) {
+async function checkInventory(args, zyteApiKey) {
     const { keyword, storeKeyword = '', storeLimit = 20, timeoutMs = 20000, } = args;
     if (!keyword || keyword.trim().length === 0) {
         throw new Error('상품 검색어(keyword)를 입력해주세요.');
@@ -27,6 +27,7 @@ async function checkInventory(args) {
         storeLimit,
     }, {
         timeout: timeoutMs,
+        zyteApiKey,
     });
     const note = !result.product
         ? '상품 검색 결과가 없어 재고를 조회하지 못했습니다. 다른 상품명이나 더 짧은 키워드로 다시 시도해주세요.'
@@ -59,7 +60,7 @@ async function checkInventory(args) {
         ],
     };
 }
-export function createCheckInventoryTool() {
+export function createCheckInventoryTool(zyteApiKey) {
     return {
         name: 'seveneleven_check_inventory',
         metadata: {
@@ -76,7 +77,7 @@ export function createCheckInventoryTool() {
                 timeoutMs: z.number().optional().default(20000).describe('요청 제한 시간(ms, 기본값: 20000)'),
             },
         },
-        handler: checkInventory,
+        handler: (args) => checkInventory(args, zyteApiKey),
     };
 }
 /* c8 ignore stop */

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

@@ -3,12 +3,13 @@
  */
 import * as z from 'zod';
 import { fetchSevenElevenCatalogSnapshot } from '../client.js';
-async function getCatalogSnapshot(args) {
+async function getCatalogSnapshot(args, zyteApiKey) {
     const { includeIssues = true, includeExhibition = true, limit = 20, timeoutMs = 15000 } = args;
     const result = await fetchSevenElevenCatalogSnapshot({
         includeIssues,
         includeExhibition,
         timeout: timeoutMs,
+        zyteApiKey,
     });
     return {
         content: [
@@ -37,7 +38,7 @@ async function getCatalogSnapshot(args) {
         ],
     };
 }
-export function createGetCatalogSnapshotTool() {
+export function createGetCatalogSnapshotTool(zyteApiKey) {
     return {
         name: 'seveneleven_get_catalog_snapshot',
         metadata: {
@@ -50,6 +51,6 @@ export function createGetCatalogSnapshotTool() {
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: getCatalogSnapshot,
+        handler: (args) => getCatalogSnapshot(args, zyteApiKey),
     };
 }