daiso 1.2.7 → 1.2.9

package/dist/utils/geocode.js

@@ -0,0 +1,155 @@
+import { fetchJson } from './http.js';
+import { searchNaverLocalPlaces } from '../services/places/client.js';
+function validKakaoDocument(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const document = value;
+    return ['place_name', 'address_name', 'road_address_name'].every((field) => document[field] === undefined || typeof document[field] === 'string');
+}
+export function readGeocodeEnvironment() {
+    const env = typeof process === 'undefined' ? {} : process.env;
+    return {
+        kakaoRestApiKey: env.KAKAO_REST_API_KEY,
+        naverClientId: env.NAVER_CLIENT_ID,
+        naverClientSecret: env.NAVER_CLIENT_SECRET,
+    };
+}
+export function geocodeBindings(bindings) {
+    return {
+        kakaoRestApiKey: bindings?.KAKAO_REST_API_KEY,
+        naverClientId: bindings?.NAVER_CLIENT_ID,
+        naverClientSecret: bindings?.NAVER_CLIENT_SECRET,
+    };
+}
+export function validKoreanCoordinates(latitude, longitude) {
+    return (Number.isFinite(latitude) &&
+        Number.isFinite(longitude) &&
+        latitude >= 33 &&
+        latitude <= 39 &&
+        longitude >= 124 &&
+        longitude <= 132);
+}
+const normalize = (value) => value
+    .replace(/특별자치시|특별자치도|특별시|광역시/gu, '')
+    .replace(/경기도/gu, '경기')
+    .replace(/충청북도/gu, '충북')
+    .replace(/충청남도/gu, '충남')
+    .replace(/전라북도|전북특별자치도/gu, '전북')
+    .replace(/전라남도/gu, '전남')
+    .replace(/경상북도/gu, '경북')
+    .replace(/경상남도/gu, '경남')
+    .replace(/강원도/gu, '강원')
+    .replace(/제주도/gu, '제주')
+    .replace(/[^0-9a-z가-힣]/giu, '')
+    .toLowerCase();
+function matches(query, value) {
+    const tokens = query
+        .replace(/^대한민국\s*/u, '')
+        .match(/[0-9]+(?:-[0-9]+)?|[a-z가-힣]+/giu)
+        ?.map((token) => (/^\d/u.test(token) ? token : normalize(token))) || [];
+    const normalized = normalize(value);
+    return (tokens.length > 0 &&
+        tokens.every((token) => /^\d+(?:-\d+)?$/u.test(token)
+            ? value.match(/\d+(?:-\d+)?/gu)?.includes(token)
+            : token.endsWith('역')
+                ? new RegExp(`${token}(?:[0-9]+호선|$|[^가-힣])`, 'u').test(value)
+                : normalized.includes(token)));
+}
+function matchesAddress(query, address) {
+    // 주소 검색은 숫자 존재뿐 아니라 도로 번호와 건물 번호의 순서도 검증합니다.
+    return (matches(query, address) &&
+        query.match(/\d+(?:-\d+)?/gu).join(',') === address.match(/\d+(?:-\d+)?/gu).join(','));
+}
+export async function searchKakaoPlaces(query, options, coordinates) {
+    const key = (options.kakaoRestApiKey ?? readGeocodeEnvironment().kakaoRestApiKey)?.trim();
+    if (!key)
+        return [];
+    const endpoint = new URL('https://dapi.kakao.com/v2/local/search/keyword.json');
+    endpoint.searchParams.set('query', query);
+    endpoint.searchParams.set('size', '15');
+    if (coordinates) {
+        endpoint.searchParams.set('x', String(coordinates.longitude));
+        endpoint.searchParams.set('y', String(coordinates.latitude));
+        endpoint.searchParams.set('radius', '20000');
+        endpoint.searchParams.set('sort', 'distance');
+    }
+    const body = await fetchJson(endpoint.toString(), {
+        fetchImpl: options.fetchImpl,
+        headers: { Authorization: `KakaoAK ${key}` },
+        timeout: options.timeout ?? options.timeoutMs ?? 10000,
+    });
+    return Array.isArray(body.documents) ? body.documents.filter(validKakaoDocument) : [];
+}
+export async function geocodeLocation(query, input = {}) {
+    const keyword = query.trim();
+    if (!keyword)
+        return null;
+    const env = readGeocodeEnvironment();
+    const options = {
+        ...input,
+        kakaoRestApiKey: input.kakaoRestApiKey ?? env.kakaoRestApiKey,
+        naverClientId: input.naverClientId ?? env.naverClientId,
+        naverClientSecret: input.naverClientSecret ?? env.naverClientSecret,
+    };
+    const isAddress = /(?:로|길|동|읍|면|리)\s*\d/u.test(keyword);
+    let documents = [];
+    if (options.kakaoRestApiKey?.trim()) {
+        try {
+            if (isAddress) {
+                const endpoint = new URL('https://dapi.kakao.com/v2/local/search/address.json');
+                endpoint.searchParams.set('query', keyword);
+                const body = await fetchJson(endpoint.toString(), {
+                    fetchImpl: options.fetchImpl,
+                    headers: { Authorization: `KakaoAK ${options.kakaoRestApiKey.trim()}` },
+                    timeout: options.timeout ?? options.timeoutMs ?? 10000,
+                });
+                documents = Array.isArray(body.documents) ? body.documents.filter(validKakaoDocument) : [];
+            }
+            else
+                documents = await searchKakaoPlaces(keyword, options);
+        }
+        catch {
+            // 장소명은 네이버 지역 검색으로 보완하고 주소는 잘못된 장소로 대체하지 않습니다.
+        }
+    }
+    for (const document of documents) {
+        if (!isAddress && !document.place_name?.trim())
+            continue;
+        const latitude = Number(document.y);
+        const longitude = Number(document.x);
+        if (!validKoreanCoordinates(latitude, longitude) ||
+            !(isAddress
+                ? matchesAddress(keyword, document.address_name || '') ||
+                    matchesAddress(keyword, document.road_address_name || '')
+                : matches(keyword, `${document.place_name} ${document.address_name || ''} ${document.road_address_name || ''}`)))
+            continue;
+        return {
+            latitude,
+            longitude,
+            formattedAddress: document.road_address_name || document.address_name || null,
+        };
+    }
+    if (!isAddress && options.naverClientId && options.naverClientSecret) {
+        try {
+            const result = await searchNaverLocalPlaces({
+                ...options,
+                keyword,
+                timeoutMs: options.timeout ?? options.timeoutMs,
+            });
+            const place = result.places.find((item) => item.latitude !== null &&
+                item.longitude !== null &&
+                validKoreanCoordinates(item.latitude, item.longitude) &&
+                matches(keyword, `${item.name} ${item.address} ${item.roadAddress}`));
+            if (place)
+                return {
+                    latitude: place.latitude,
+                    longitude: place.longitude,
+                    formattedAddress: place.roadAddress || place.address || null,
+                };
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}

package/dist/utils/http.js

@@ -67,7 +67,7 @@ function parseRetryAfterDelayMs(response) {
     return null;
 }
 async function requestWithTimeout(url, options, readResponse) {
-    const { timeout = 10000, retries = 0, retryDelayMs = 250, retryStatusCodes = DEFAULT_RETRY_STATUS_CODES, retryUnsafeMethods = false, retryMethods = DEFAULT_RETRY_METHODS, onRetry, expectedStatus: _expectedStatus, ...restOptions } = options;
+    const { timeout = 10000, fetchImpl = fetch, retries = 0, retryDelayMs = 250, retryStatusCodes = DEFAULT_RETRY_STATUS_CODES, retryUnsafeMethods = false, retryMethods = DEFAULT_RETRY_METHODS, onRetry, expectedStatus: _expectedStatus, ...restOptions } = options;
     const maxAttempts = Math.max(1, Math.trunc(retries) + 1);
     const method = normalizeMethod(restOptions.method);
     const retryAllowed = canRetryMethod(method, retryMethods, retryUnsafeMethods);
@@ -77,7 +77,7 @@ async function requestWithTimeout(url, options, readResponse) {
         const started = Date.now();
         let responseStatus;
         try {
-            const response = await fetch(url, {
+            const response = await fetchImpl(url, {
                 ...restOptions,
                 signal: controller.signal,
             });

package/dist/utils/relayQuota.js

@@ -3,7 +3,9 @@ export function parseRelayQuota(status, headers) {
         return undefined;
     const reason = headers.get('x-relay-quota-reason');
     const retry = headers.get('retry-after') || '';
-    if (reason !== 'minute' && reason !== 'daily' && reason !== 'consumer')
+    if (reason !== 'minute' && reason !== 'daily' && reason !== 'consumer' && reason !== 'consumer-busy')
+        return undefined;
+    if (reason === 'consumer-busy' && retry !== '1')
         return undefined;
     if (!/^[1-9][0-9]{0,4}$/.test(retry) || Number(retry) > 86400)
         return undefined;
@@ -27,7 +29,7 @@ export function createRelayCooldown(now = () => Date.now(), maxEntries = 1024) {
         },
         set(scope, consumer, quota) {
             prune();
-            const key = quota.quotaReason === 'consumer' ? `${scope}:${consumer}` : scope;
+            const key = (quota.quotaReason === 'consumer' || quota.quotaReason === 'consumer-busy') ? `${scope}:${consumer}` : scope;
             if (!entries.has(key) && entries.size >= maxEntries)
                 return;
             const until = now() + quota.retryAfter * 1000;

package/openapi.json

@@ -91,8 +91,6 @@
                 "emart24FindStores",
                 "emart24SearchProducts",
                 "emart24CheckInventory",
-                "lottemartFindStores",
-                "lottemartSearchProducts",
                 "gs25FindStores",
                 "gs25SearchProducts",
                 "gs25CheckInventory",
@@ -300,7 +298,7 @@
             "name": "area",
             "in": "query",
             "required": false,
-            "description": "롯데마트 지역",
+            "description": "지역",
             "schema": {
               "type": "string"
             }
@@ -336,7 +334,7 @@
             "name": "brandVariant",
             "in": "query",
             "required": false,
-            "description": "롯데마트 브랜드 변형",
+            "description": "브랜드 변형",
             "schema": {
               "type": "string"
             }
@@ -383,7 +381,7 @@
             "name": "pageLimit",
             "in": "query",
             "required": false,
-            "description": "롯데마트 추가 페이지 수",
+            "description": "추가 페이지 수",
             "schema": {
               "type": "integer"
             }
@@ -446,7 +444,7 @@
             "name": "storeName",
             "in": "query",
             "required": false,
-            "description": "매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.",
+            "description": "매장명",
             "schema": {
               "type": "string"
             }
@@ -2084,183 +2082,6 @@
           }
         }
       },
-      "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": {

package/openapi.yaml

@@ -77,8 +77,6 @@ paths:
               - emart24FindStores
               - emart24SearchProducts
               - emart24CheckInventory
-              - lottemartFindStores
-              - lottemartSearchProducts
               - gs25FindStores
               - gs25SearchProducts
               - gs25CheckInventory
@@ -222,7 +220,7 @@ paths:
         - name: area
           in: query
           required: false
-          description: 롯데마트 지역
+          description: 지역
           schema:
             type: string
         - name: area1
@@ -246,7 +244,7 @@ paths:
         - name: brandVariant
           in: query
           required: false
-          description: 롯데마트 브랜드 변형
+          description: 브랜드 변형
           schema:
             type: string
         - name: lat
@@ -278,7 +276,7 @@ paths:
         - name: pageLimit
           in: query
           required: false
-          description: 롯데마트 추가 페이지 수
+          description: 추가 페이지 수
           schema:
             type: integer
         - name: pageSize
@@ -320,7 +318,7 @@ paths:
         - name: storeName
           in: query
           required: false
-          description: 매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.
+          description: 매장명
           schema:
             type: string
         - name: storeKeyword
@@ -1460,131 +1458,6 @@ components:
                     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:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "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": {
@@ -59,7 +59,6 @@
     "cu",
     "seveneleven",
     "emart24",
-    "lottemart",
     "cgv",
     "megabox",
     "lottecinema",