daiso 1.0.9 → 1.0.10

package/README.md

@@ -7,7 +7,7 @@
 
 # Daiso MCP 및 Skill
 
-다이소(제품/매장/재고), 키 없는 통합 가격 후보 비교, 주변 음식점/카페, 개발자 요청 제출, 롯데마트(매장/상품), GS25(매장/상품/재고), 세븐일레븐(상품/매장/재고/인기검색어/카탈로그), CU(매장/재고), 이마트24(매장/상품/재고), 올리브영(매장/재고), 메가박스(지점/영화/시간표/좌석), 롯데시네마(지점/영화/좌석), CGV(극장/영화/시간표) 조회 기능을 MCP, CLI, Codex Skill로 AI에 연결합니다.
+다이소(제품/매장/재고), 상품 가격 비교, 주변 음식점/카페, 주유소/유가, 개발자 요청 제출, 롯데마트(매장/상품), GS25(매장/상품/재고), 세븐일레븐(상품/매장/재고/인기검색어/카탈로그), CU(매장/재고), 이마트24(매장/상품/재고), 올리브영(매장/재고), 메가박스(지점/영화/시간표/좌석), 롯데시네마(지점/영화/좌석), CGV(극장/영화/시간표) 조회 기능을 MCP, CLI, Codex Skill로 AI에 연결합니다.
 
 <br>
 
@@ -15,7 +15,8 @@
 
 **ClawHub:** [clawhub.ai/hmmhmmhm/daiso-cli](https://clawhub.ai/hmmhmmhm/daiso-cli)
 
-한국 로컬 리테일과 영화관 조회를 MCP, CLI, Codex Skill로 연결하는 도구입니다.
+한국 로컬 리테일, 생활 정보, 영화관 조회를 MCP, CLI, Codex Skill로 연결하는 도구입니다.
+사용자는 별도 API 키를 준비하지 않고 바로 사용할 수 있습니다.
 
 <br>
 
@@ -35,10 +36,15 @@
       <td>네이버 지역 검색</td>
       <td>음식점, 카페, 디저트, 주변 장소</td>
     </tr>
+    <tr>
+      <td>교통</td>
+      <td>오피넷</td>
+      <td>전국 평균 유가, 최저가 주유소, 위치 기반 주유소, 주유소 상세정보</td>
+    </tr>
     <tr>
       <td>비교</td>
       <td>다이소, GS25, 세븐일레븐, 이마트24</td>
-      <td>새 외부 키 없는 상품 가격 후보 비교</td>
+      <td>같은 상품의 판매처별 가격 후보 비교</td>
     </tr>
     <tr>
       <td>운영</td>
@@ -75,11 +81,11 @@
 **[실시간 서비스 상태 보기](https://aka-page.betteruptime.com/)**
 
 <!-- WORKERS_INVOCATIONS_CHART:START -->
-<h3>Cloudflare Workers 호출량 (2026-03-01 ~ 2026-05-27, 88일)</h3>
+<h3>Cloudflare Workers 호출량 (2026-06-14 ~ 2026-07-13, 30일)</h3>
 
-<img src="./assets/analytics/workers-invocations.png?v=2026-05-27T22:46:35.568Z" alt="Cloudflare Workers 호출량 그래프 (2026-03-01 ~ 2026-05-27)" width="100%">
+<img src="./assets/analytics/workers-invocations.png?v=2026-07-13T16:10:36.883Z" alt="Cloudflare Workers 호출량 그래프 (2026-06-14 ~ 2026-07-13)" width="100%">
 
-<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-05-28 07:46 KST</sub>
+<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-07-14 01:10 KST</sub>
 
 <!-- WORKERS_INVOCATIONS_CHART:END -->
 
@@ -127,6 +133,8 @@ GS25 mcp로 강남 근처 매장과 오감자 재고 알려줘
 세븐일레븐 mcp로 인기 검색어와 카탈로그 요약 알려줘
 강남역 근처 카페 찾아줘
 성수동 근처 브런치 음식점 찾아줘
+강남역 근처 제일 싼 주유소 찾아줘
+오늘 전국 평균 휘발유 가격 알려줘
 메가박스 mcp로 강남점 영화와 잔여 좌석 알려줘
 롯데시네마 mcp로 월드타워 근처 지점과 상영 영화 알려줘
 롯데시네마 mcp로 월드타워 잔여 좌석 알려줘
@@ -137,6 +145,7 @@ CGV mcp로 강남 상영 영화와 시간표 알려줘
 
 - 가격 비교: `콜라 어디가 싸?` → `compare_products`
 - 주변 장소: `강남역 근처 카페 찾아줘` → `places_search_nearby`
+- 주유소/유가: `강남역 근처 제일 싼 주유소 찾아줘` → `opinet_search_stations_around`
 - 브랜드 명시 재고: `다이소 핫식스 재고 찾아줘` → 먼저 다이소에서 검색 후 결과 없을 때만 대안 제안
 - 편의점 재고: `GS25 강남 오감자 재고` → 상품 후보 확인 후 재고 조회
 - 영화 시간표: `오늘 강남 CGV 시간표` → KST 오늘 날짜로 극장 검색 후 시간표 조회
@@ -330,9 +339,9 @@ MCP 도구 응답은 각 서비스의 원본 필드를 유지하면서, 클라
 - `standard.theaters`: 영화관 목록을 `code`, `name`, `address`, `distanceMeters`, `raw` 형태로 정규화합니다.
 - `standard.places`: 음식점/카페 같은 장소 목록을 `name`, `address`, `raw` 중심으로 정규화합니다.
 
-### 키 없는 통합 가격 후보 비교
+### 통합 상품 가격 비교
 
-새 외부 API 키 없이 기존 상품 검색을 묶어 가격 후보를 비교합니다.
+여러 리테일/편의점 상품 검색 결과를 묶어 같은 상품의 판매처별 가격 후보를 비교합니다.
 
 ```bash
 npx daiso compare 콜라 --limit 3 --json

package/dist/api/healthCheckDefinitions.js

@@ -6,6 +6,19 @@ export const GS25_CLOUDFRONT_403_PATTERNS = [
     'The request could not be satisfied',
     '403 ERROR',
 ];
+export const EMART24_UPSTREAM_403_PATTERNS = [
+    '403 Forbidden',
+    '<title>403 Forbidden</title>',
+];
+export const CU_UPSTREAM_BLOCK_PATTERNS = [
+    '400 Bad Request',
+    'Request Blocked',
+];
+export const SEVENELEVEN_UPSTREAM_403_PATTERNS = [
+    '403 Forbidden',
+    '_Incapsula_Resource',
+    'NOINDEX, NOFOLLOW',
+];
 export const HEALTH_CHECKS = [
     {
         id: 'cli.contract',
@@ -41,6 +54,7 @@ export const HEALTH_CHECKS = [
         path: '/api/emart24/products?keyword=%EC%BB%A4%ED%94%BC&pageSize=1',
         collectionKey: 'products',
         requiredFields: ['pluCd', 'goodsName', 'itemName', 'name'],
+        degradedFailurePatterns: EMART24_UPSTREAM_403_PATTERNS,
     },
     {
         id: 'gs25.products',
@@ -69,6 +83,7 @@ export const HEALTH_CHECKS = [
         path: '/api/seveneleven/products?query=%EC%BB%A4%ED%94%BC&size=1',
         collectionKey: 'products',
         requiredFields: ['itemCode', 'itemName', 'productNo', 'name'],
+        degradedFailurePatterns: SEVENELEVEN_UPSTREAM_403_PATTERNS,
     },
     {
         id: 'lottemart.products',
@@ -124,6 +139,7 @@ export const HEALTH_CHECKS = [
         path: '/api/cu/inventory?keyword=%EC%BB%A4%ED%94%BC&size=1&storeLimit=0&storeCheck=false',
         collectionKey: 'inventoryItems',
         requiredFields: ['itemCode', 'itemName', 'name'],
+        degradedFailurePatterns: CU_UPSTREAM_BLOCK_PATTERNS,
     },
     {
         id: 'emart24.inventory',
@@ -133,6 +149,7 @@ export const HEALTH_CHECKS = [
         path: '/api/emart24/inventory?keyword=%EC%BB%A4%ED%94%BC&storeKeyword=%EA%B0%95%EB%82%A8&limit=1',
         collectionKey: 'inventoryItems',
         requiredFields: ['pluCd', 'goodsName', 'itemName', 'name'],
+        degradedFailurePatterns: EMART24_UPSTREAM_403_PATTERNS,
     },
     {
         id: 'gs25.inventory',
@@ -156,6 +173,7 @@ export const HEALTH_CHECKS = [
         path: '/api/seveneleven/inventory?keyword=%EC%BB%A4%ED%94%BC&storeKeyword=%EA%B0%95%EB%82%A8&size=1',
         collectionKey: 'inventoryItems',
         requiredFields: ['itemCode', 'itemName', 'productNo', 'name'],
+        degradedFailurePatterns: SEVENELEVEN_UPSTREAM_403_PATTERNS,
     },
     {
         id: 'oliveyoung.inventory',

package/dist/api/healthChecks.js

@@ -1,7 +1,7 @@
 /**
  * 개별 서비스 헬스 체크 실행기
  */
-import { GS25_CLOUDFRONT_403_PATTERNS, HEALTH_CHECKS } from './healthCheckDefinitions.js';
+import { EMART24_UPSTREAM_403_PATTERNS, GS25_CLOUDFRONT_403_PATTERNS, HEALTH_CHECKS, SEVENELEVEN_UPSTREAM_403_PATTERNS, } from './healthCheckDefinitions.js';
 import { hasRequiredRepresentativeFields, toCount, toFirstName } from './healthCheckShape.js';
 const HEALTH_CHECK_CACHE_TTL_MS = 300_000;
 const DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 7000;
@@ -71,7 +71,16 @@ function shouldDegradeFailedResponse(check, message) {
     return check.degradedFailurePatterns?.some((pattern) => message.includes(pattern)) ?? false;
 }
 function shouldDegradeCliContractPath(path, message) {
-    return path.startsWith('/api/gs25/') && GS25_CLOUDFRONT_403_PATTERNS.some((pattern) => message.includes(pattern));
+    if (path.startsWith('/api/gs25/')) {
+        return GS25_CLOUDFRONT_403_PATTERNS.some((pattern) => message.includes(pattern));
+    }
+    if (path.startsWith('/api/emart24/')) {
+        return EMART24_UPSTREAM_403_PATTERNS.some((pattern) => message.includes(pattern));
+    }
+    if (path.startsWith('/api/seveneleven/')) {
+        return SEVENELEVEN_UPSTREAM_403_PATTERNS.some((pattern) => message.includes(pattern));
+    }
+    return false;
 }
 function resolveCheckTimeoutMs(check, timeoutMs) {
     if (check.timeoutMs === undefined) {

package/dist/cli/commands/convenience.js

@@ -229,7 +229,7 @@ export async function handleSevenElevenProducts(options, deps) {
         deps,
         path: '/api/seveneleven/products',
         configure: (parsed) => {
-            const query = parsed.positionals[0];
+            const query = parsed.positionals[0] || parsed.options.query;
             if (!query) {
                 return 'seveneleven-products 명령은 검색어가 필요합니다. 예: daiso seveneleven-products 삼각김밥';
             }
@@ -245,7 +245,7 @@ export async function handleSevenElevenStores(options, deps) {
         deps,
         path: '/api/seveneleven/stores',
         configure: (parsed) => {
-            const keyword = parsed.positionals[0];
+            const keyword = parsed.positionals[0] || parsed.options.keyword;
             if (!keyword) {
                 return 'seveneleven-stores 명령은 검색어가 필요합니다. 예: daiso seveneleven-stores 안산 중앙역';
             }

package/dist/services/cgv/client.js

@@ -6,6 +6,9 @@ import { CGV_API } from './api.js';
 import { requestCgv } from './transport.js';
 const DEFAULT_THEATER_CODE = '0056';
 const MAX_FALLBACK_THEATERS = 5;
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
 async function resolveTheaterCode(playDate, theaterCode, params) {
     if (theaterCode) {
         return theaterCode;
@@ -25,7 +28,7 @@ async function fetchMoviesByTheaterCode(playDate, theaterCode, params) {
         scnYmd: playDate,
     });
     const response = await requestCgv(CGV_API.MOVIE_LIST_PATH, searchParams, params.timeout, params.zyteApiKey);
-    return (response.data || [])
+    return asArray(response.data)
         .filter((item) => item.movNo && item.movNm)
         .map((item) => ({
         movieCode: item.movNo,
@@ -42,7 +45,7 @@ async function fetchTimetableByMovieCode(playDate, theaterCode, movieCode, param
         rtctlScopCd: CGV_API.TIMETABLE_SCOPE_CODE,
     });
     const response = await requestCgv(CGV_API.TIMETABLE_PATH, searchParams, params.timeout, params.zyteApiKey);
-    return (response.data || [])
+    return asArray(response.data)
         .filter((item) => item.siteNo && item.movNo && item.scnYmd)
         .map((item) => ({
         scheduleId: `${item.scnYmd}${item.siteNo}${item.scnSseq || ''}`,
@@ -65,7 +68,7 @@ async function fetchTimetableBySite(playDate, theaterCode, params) {
         rtctlScopCd: CGV_API.TIMETABLE_SITE_SCOPE_CODE,
     });
     const response = await requestCgv(CGV_API.TIMETABLE_BY_SITE_PATH, searchParams, params.timeout, params.zyteApiKey);
-    return (response.data || [])
+    return asArray(response.data)
         .filter((item) => item.siteNo && item.scnYmd)
         .map((item) => ({
         scheduleId: `${item.scnYmd}${item.siteNo}${item.scnSseq || ''}`,
@@ -85,7 +88,7 @@ export async function fetchCgvTheaters(params) {
         coCd: CGV_API.COMPANY_CODE,
     });
     const response = await requestCgv(CGV_API.THEATER_LIST_PATH, searchParams, params.timeout, params.zyteApiKey);
-    const list = (response.data || []).flatMap((region) => (region.siteList || []).map((site) => ({
+    const list = asArray(response.data).flatMap((region) => asArray(region.siteList).map((site) => ({
         theaterCode: site.siteNo || '',
         theaterName: site.siteNm || '',
         regionCode: region.regnGrpCd || undefined,

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

@@ -14,25 +14,41 @@ async function searchProducts(args) {
     if (!keyword || keyword.trim().length === 0) {
         throw new Error('상품 검색어(keyword)를 입력해주세요.');
     }
-    const result = await searchEmart24Products({
-        keyword,
-        page,
-        pageSize,
-        sortType,
-        saleProductYn,
-    }, {
-        timeout: timeoutMs,
-    });
-    return buildTextResponse({
-        keyword,
-        page,
-        pageSize,
-        sortType,
-        saleProductYn,
-        totalCount: result.totalCount,
-        count: result.products.length,
-        products: result.products,
-    });
+    try {
+        const result = await searchEmart24Products({
+            keyword,
+            page,
+            pageSize,
+            sortType,
+            saleProductYn,
+        }, {
+            timeout: timeoutMs,
+        });
+        return buildTextResponse({
+            keyword,
+            page,
+            pageSize,
+            sortType,
+            saleProductYn,
+            totalCount: result.totalCount,
+            count: result.products.length,
+            products: result.products,
+        });
+    }
+    catch (error) {
+        return buildTextResponse({
+            keyword,
+            page,
+            pageSize,
+            sortType,
+            saleProductYn,
+            totalCount: 0,
+            count: 0,
+            products: [],
+            status: 'degraded',
+            message: error instanceof Error ? error.message : '이마트24 상품 검색에 실패했습니다.',
+        });
+    }
 }
 const searchProductsOutputSchema = {
     keyword: z.string().describe('검색어'),
@@ -43,6 +59,8 @@ const searchProductsOutputSchema = {
     totalCount: z.number().describe('검색된 전체 상품 수'),
     count: z.number().describe('반환된 상품 수'),
     products: z.array(z.unknown()).describe('이마트24 상품 검색 결과'),
+    status: z.string().optional().describe('외부 API 차단 등으로 결과가 제한된 경우 degraded'),
+    message: z.string().optional().describe('degraded 상태의 원인 메시지'),
 };
 export function createSearchProductsTool() {
     return {

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/tools/searchProducts.js

@@ -14,23 +14,40 @@ async function searchProducts(args) {
     if (!query || query.trim().length === 0) {
         throw new Error('상품 검색어(query)를 입력해주세요.');
     }
-    const result = await searchSevenElevenProductsWithVariants(query, {
-        page,
-        size,
-        sort,
-        timeout: timeoutMs,
-    });
-    return buildTextResponse({
-        query: result.query,
-        page,
-        size,
-        sort,
-        totalCount: result.totalCount,
-        count: result.products.length,
-        collectionIds: result.collectionIds,
-        appliedQueries: result.appliedQueries,
-        products: result.products,
-    });
+    try {
+        const result = await searchSevenElevenProductsWithVariants(query, {
+            page,
+            size,
+            sort,
+            timeout: timeoutMs,
+        });
+        return buildTextResponse({
+            query: result.query,
+            page,
+            size,
+            sort,
+            totalCount: result.totalCount,
+            count: result.products.length,
+            collectionIds: result.collectionIds,
+            appliedQueries: result.appliedQueries,
+            products: result.products,
+        });
+    }
+    catch (error) {
+        return buildTextResponse({
+            query,
+            page,
+            size,
+            sort,
+            totalCount: 0,
+            count: 0,
+            collectionIds: [],
+            appliedQueries: [query],
+            products: [],
+            status: 'degraded',
+            message: error instanceof Error ? error.message : '세븐일레븐 상품 검색에 실패했습니다.',
+        });
+    }
 }
 const searchProductsOutputSchema = {
     query: z.string().describe('적용된 검색어'),
@@ -42,6 +59,8 @@ const searchProductsOutputSchema = {
     collectionIds: z.array(z.string()).describe('검색 컬렉션 ID 목록'),
     appliedQueries: z.array(z.string()).describe('실제로 시도한 검색어 목록'),
     products: z.array(z.unknown()).describe('세븐일레븐 상품 검색 결과'),
+    status: z.string().optional().describe('외부 API 차단 등으로 결과가 제한된 경우 degraded'),
+    message: z.string().optional().describe('degraded 상태의 원인 메시지'),
 };
 export function createSearchProductsTool() {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "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": {
@@ -79,34 +79,37 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.15",
-    "@cloudflare/workers-types": "^4.20260526.1",
+    "@biomejs/biome": "^2.5.2",
+    "@cloudflare/workers-types": "^4.20260702.1",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.1.0",
     "@vitest/coverage-v8": "^4.1.7",
-    "eslint": "^10.4.0",
+    "eslint": "^10.6.0",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^17.4.0",
+    "globals": "^17.7.0",
     "jiti": "^2.7.0",
-    "playwright": "^1.60.0",
-    "prettier": "^3.8.3",
-    "sharp": "^0.34.5",
-    "tsx": "^4.22.3",
+    "playwright": "^1.61.1",
+    "prettier": "^3.9.4",
+    "sharp": "^0.35.3",
+    "tsx": "^4.23.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.0",
+    "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.7",
-    "wrangler": "^4.95.0"
+    "wrangler": "^4.107.0"
   },
   "overrides": {
     "flatted": "3.4.2",
-    "undici": "7.24.0",
+    "undici": "7.28.0",
     "brace-expansion": "5.0.6",
-    "ws": "8.20.1"
+    "ws": "8.21.0",
+    "tmp": "0.2.7",
+    "markdown-it": "14.2.0",
+    "esbuild": "0.28.1"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "hono": "^4.12.23",
-    "proj4": "^2.20.8",
+    "hono": "^4.12.27",
+    "proj4": "^2.20.9",
     "workers-mcp": "^0.0.13"
   }
 }