daiso 1.0.7 → 1.0.8

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>
 
@@ -35,6 +35,11 @@
       <td>네이버 지역 검색</td>
       <td>음식점, 카페, 디저트, 주변 장소</td>
     </tr>
+    <tr>
+      <td>비교</td>
+      <td>다이소, GS25, 세븐일레븐, 이마트24</td>
+      <td>새 외부 키 없는 상품 가격 후보 비교</td>
+    </tr>
     <tr>
       <td>리테일</td>
       <td>다이소, 올리브영, 롯데마트</td>
@@ -65,11 +70,11 @@
 **[실시간 서비스 상태 보기](https://aka-page.betteruptime.com/)**
 
 <!-- WORKERS_INVOCATIONS_CHART:START -->
-<h3>Cloudflare Workers 호출량 (2026-03-01 ~ 2026-05-21, 82일)</h3>
+<h3>Cloudflare Workers 호출량 (2026-03-01 ~ 2026-05-23, 84일)</h3>
 
-<img src="./assets/analytics/workers-invocations.png?v=2026-05-23T04:50:41.937Z" alt="Cloudflare Workers 호출량 그래프 (2026-03-01 ~ 2026-05-21)" width="100%">
+<img src="./assets/analytics/workers-invocations.png?v=2026-05-23T15:44:29.609Z" alt="Cloudflare Workers 호출량 그래프 (2026-03-01 ~ 2026-05-23)" width="100%">
 
-<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-05-23 13:50 KST</sub>
+<sub>기준 워커: <code>daiso-mcp</code> · 마지막 갱신: 2026-05-24 00:44 KST</sub>
 
 <!-- WORKERS_INVOCATIONS_CHART:END -->
 
@@ -105,6 +110,7 @@ ChatGPT, Claude, Grok 같은 AI 앱에서 바로 연결해 사용할 수 있습
 
 ```
 다이소 mcp로 수납박스 검색해줘
+콜라 어디가 싼지 비교해줘
 올리브영 mcp로 명동 근처 매장 찾아줘
 이마트24 mcp로 강남 근처 매장과 두바이 재고 알려줘
 롯데마트 mcp로 잠실 근처 매장 찾아줘
@@ -254,6 +260,7 @@ npx daiso product 1034604
 npx daiso stores 강남역
 npx daiso inventory 1034604 --keyword 강남역
 npx daiso display-location 1034604 04515
+npx daiso compare 콜라 --limit 3
 npx daiso places 강남역 --category cafe --limit 5
 npx daiso places 성수동 --keyword 브런치 --limit 5
 npx daiso cu-stores 강남
@@ -304,6 +311,22 @@ MCP 도구 응답은 각 서비스의 원본 필드를 유지하면서, 클라
 - `standard.theaters`: 영화관 목록을 `code`, `name`, `address`, `distanceMeters`, `raw` 형태로 정규화합니다.
 - `standard.places`: 음식점/카페 같은 장소 목록을 `name`, `address`, `raw` 중심으로 정규화합니다.
 
+### 키 없는 통합 가격 후보 비교
+
+새 외부 API 키 없이 기존 상품 검색을 묶어 가격 후보를 비교합니다.
+
+```bash
+npx daiso compare 콜라 --limit 3 --json
+```
+
+REST:
+
+```text
+GET /api/compare/products?keyword=콜라&limit=3
+```
+
+지원 서비스는 `daiso`, `gs25`, `seveneleven`, `emart24`입니다. GS25처럼 상품 검색 응답에 가격이 없는 서비스는 후보에는 포함되지만 최저가 계산에서는 제외됩니다.
+
 ### 운영 헬스 체크
 
 공개 상태 페이지: **[Daiso MCP Status](https://aka-page.betteruptime.com/)**

package/dist/api/actionsProxy.js

@@ -86,6 +86,11 @@ export const ACTION_QUERY_DEFINITIONS = [
         summary: '세븐일레븐 카탈로그 조회',
         targetPath: '/api/seveneleven/catalog',
     },
+    {
+        action: 'compareProducts',
+        summary: '키 없는 통합 상품 가격 후보 비교',
+        targetPath: '/api/compare/products',
+    },
     {
         action: 'placesSearchNearby',
         summary: '음식점/카페 등 주변 장소 검색',

package/dist/api/compareHandlers.js

@@ -0,0 +1,26 @@
+import { compareProducts, parseCompareServices } from '../services/compare/client.js';
+import { errorResponse, successResponse } from './response.js';
+export async function handleCompareProducts(c) {
+    const keyword = c.req.query('keyword') || c.req.query('q') || '';
+    const limit = parseInt(c.req.query('limit') || '5', 10);
+    const services = parseCompareServices(c.req.query('services'));
+    if (keyword.trim().length === 0) {
+        return errorResponse(c, 'MISSING_KEYWORD', '검색어(keyword)를 입력해주세요.');
+    }
+    try {
+        const result = await compareProducts({
+            keyword,
+            limit,
+            services,
+        });
+        return successResponse(c, result, {
+            total: result.resultCount,
+            page: 1,
+            pageSize: limit,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '알 수 없는 오류가 발생했습니다.';
+        return errorResponse(c, 'COMPARE_PRODUCTS_FAILED', message, 500);
+    }
+}

package/dist/api/routes/compareRoutes.js

@@ -0,0 +1,9 @@
+import { withEdgeCache } from '../../utils/cache.js';
+import { handleCompareProducts } from '../compareHandlers.js';
+export function registerCompareRoutes(app) {
+    app.get('/api/compare/products', async (c) => withEdgeCache(c.req.url, {
+        ttlSeconds: 60 * 10,
+        staleWhileRevalidateSeconds: 60,
+        keyPrefix: 'compare-products-v1',
+    }, () => handleCompareProducts(c)));
+}

package/dist/cli/commandOptions.js

@@ -12,6 +12,7 @@ export const COMMAND_OPTION_ALLOWLISTS = {
     stores: ['help', 'json', 'keyword', 'sido', 'gugun', 'dong', 'limit'],
     inventory: ['help', 'json', 'keyword', 'lat', 'lng', 'page', 'pageSize'],
     'display-location': ['help', 'json'],
+    compare: ['help', 'json', 'keyword', 'q', 'services', 'limit'],
     places: ['help', 'json', 'location', 'category', 'keyword', 'limit', 'start', 'sort'],
     'cu-stores': ['help', 'json', 'keyword', 'lat', 'lng', 'limit'],
     'cu-inventory': [

package/dist/cli/commands/convenience.js

@@ -6,6 +6,24 @@ import { printCommandHelp } from '../../cliHelp.js';
 import { parseCliArgs, toUrl, applyOptionsToQuery, toQueryOptions } from '../args.js';
 import { validateCommandOptions } from '../commandOptions.js';
 import { requestAndPrintResponse } from '../http.js';
+export async function handleCompareProducts(options, deps) {
+    const parsed = parseCliArgs(options);
+    if (parsed.options.help === 'true') {
+        return printCommandHelp('compare', deps.writeOut, deps.writeErr);
+    }
+    if (validateCommandOptions('compare', parsed.options, deps.writeErr)) {
+        return 1;
+    }
+    const keyword = parsed.positionals[0] || parsed.options.keyword || parsed.options.q;
+    if (!keyword) {
+        deps.writeErr('compare 명령은 검색어가 필요합니다. 예: daiso compare 콜라');
+        return 1;
+    }
+    const targetUrl = toUrl('/api/compare/products');
+    targetUrl.searchParams.set('keyword', keyword);
+    applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
+    return await requestAndPrintResponse(deps.fetchImpl, deps.writeOut, deps.writeErr, targetUrl, 'compare', parsed.options.json === 'true');
+}
 export async function handlePlaces(options, deps) {
     const parsed = parseCliArgs(options);
     if (parsed.options.help === 'true') {

package/dist/cli.js

@@ -12,7 +12,7 @@ import { DEFAULT_BASE_URL, DEFAULT_MCP_URL } from './cli/constants.js';
 import { parseCliArgs } from './cli/args.js';
 import { validateCommandOptions } from './cli/commandOptions.js';
 import { handleGet, handleProducts, handleProduct, handleStores, handleInventory, handleDisplayLocation, } from './cli/commands/daiso.js';
-import { handleCuStores, handleCuInventory, handleEmart24Stores, handleEmart24Products, handleEmart24Inventory, handleLotteMartStores, handleLotteMartProducts, handlePlaces, handleGs25Stores, handleGs25Products, handleGs25Inventory, handleSevenElevenProducts, handleSevenElevenStores, handleSevenElevenPopwords, handleSevenElevenCatalog, handleLottecinemaTheaters, handleLottecinemaMovies, handleLottecinemaSeats, } from './cli/commands/convenience.js';
+import { handleCuStores, handleCuInventory, handleEmart24Stores, handleEmart24Products, handleEmart24Inventory, handleLotteMartStores, handleLotteMartProducts, handleCompareProducts, handlePlaces, handleGs25Stores, handleGs25Products, handleGs25Inventory, handleSevenElevenProducts, handleSevenElevenStores, handleSevenElevenPopwords, handleSevenElevenCatalog, handleLottecinemaTheaters, handleLottecinemaMovies, handleLottecinemaSeats, } from './cli/commands/convenience.js';
 function rejectTopLevelUnknownOptions(options, command, deps) {
     const parsed = parseCliArgs(options);
     return validateCommandOptions(command, parsed.options, deps.writeErr);
@@ -112,6 +112,8 @@ export async function runCli(argv, deps) {
         return await handleInventory(options, resolvedDeps);
     if (command === 'display-location')
         return await handleDisplayLocation(options, resolvedDeps);
+    if (command === 'compare')
+        return await handleCompareProducts(options, resolvedDeps);
     if (command === 'places')
         return await handlePlaces(options, resolvedDeps);
     if (command === 'cu-stores')

package/dist/cliHelp.js

@@ -13,6 +13,7 @@ export const COMMAND_LIST = [
     'stores',
     'inventory',
     'display-location',
+    'compare',
     'places',
     'cu-stores',
     'cu-inventory',
@@ -44,6 +45,7 @@ const COMMAND_SUMMARY = {
     stores: '다이소 매장 검색',
     inventory: '다이소 재고 조회',
     'display-location': '다이소 진열 위치 조회',
+    compare: '키 없는 통합 상품 가격 후보 비교',
     places: '음식점/카페 등 주변 장소 검색',
     'cu-stores': 'CU 매장 검색',
     'cu-inventory': 'CU 재고 조회',
@@ -139,6 +141,15 @@ const COMMAND_DETAIL = {
         '옵션: --json',
         '예시: daiso display-location 1034604 04515',
     ],
+    compare: [
+        '명령: compare',
+        '설명: 새 외부 키 없이 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다.',
+        '사용법: daiso compare <keyword> [--services daiso,gs25,seveneleven,emart24] [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --services, --limit, --json',
+        '예시: daiso compare 콜라 --limit 3',
+        '예시: daiso compare 컵라면 --services seveneleven,emart24 --json',
+    ],
     places: [
         '명령: places',
         '설명: 네이버 지역 검색으로 음식점, 카페, 디저트 가게 등 주변 장소를 검색합니다.',

package/dist/cliRenderer.js

@@ -174,6 +174,18 @@ function formatInventory(data) {
     }
     return lines;
 }
+function formatCompare(data) {
+    const lines = [];
+    if (isRecord(data.bestPrice)) {
+        lines.push(`최저가 후보: ${toText(data.bestPrice.serviceName)} / ${toText(data.bestPrice.name)} / ${toText(data.bestPrice.price)}원`);
+    }
+    lines.push(...formatCollection('가격 후보', data.results));
+    lines.push(...formatCollection('오류', data.errors));
+    if (typeof data.note === 'string') {
+        lines.push(`참고: ${data.note}`);
+    }
+    return lines;
+}
 export function renderApiEnvelope(command, url, payload) {
     if (!isRecord(payload)) {
         return `요청 성공: ${url.pathname}\n${toText(payload)}\n\n원본 JSON은 --json 옵션으로 확인하세요.`;
@@ -199,6 +211,9 @@ export function renderApiEnvelope(command, url, payload) {
     else if (command === 'display-location') {
         lines.push(...formatDisplayLocation(data));
     }
+    else if (command === 'compare') {
+        lines.push(...formatCompare(data));
+    }
     else if (command === 'cu-inventory') {
         lines.push(...formatCollection('매장 목록', isRecord(data.nearbyStores) ? data.nearbyStores.stores : undefined));
         lines.push(...formatCollection('재고 항목', isRecord(data.inventory) ? data.inventory.items : undefined));

package/dist/core/registry.js

@@ -7,6 +7,18 @@ import * as z from 'zod';
 import { getErrorMessage, toStandardErrorDiagnostics } from './errors.js';
 const DEFAULT_OUTPUT_SCHEMA = z.object({}).loose().describe('도구 실행 결과(JSON 객체)');
 function createFallbackOutputSchema(toolName) {
+    if (toolName.includes('compare')) {
+        return {
+            keyword: z.string().optional(),
+            services: z.array(z.string()).optional(),
+            serviceCount: z.number().optional(),
+            resultCount: z.number().optional(),
+            bestPrice: z.unknown().optional(),
+            results: z.array(z.unknown()).optional(),
+            errors: z.array(z.unknown()).optional(),
+            note: z.string().optional(),
+        };
+    }
     if (toolName.includes('search_products') ||
         toolName.includes('searchProducts') ||
         toolName.endsWith('_products')) {

package/dist/index.js

@@ -20,6 +20,7 @@ import { createEmart24Service } from './services/emart24/index.js';
 import { createGs25Service } from './services/gs25/index.js';
 import { createSevenElevenService } from './services/seveneleven/index.js';
 import { createPlacesService } from './services/places/index.js';
+import { createCompareService } from './services/compare/index.js';
 import { createPromptResponse } from './pages/prompt.js';
 import { createFullOpenApiJsonResponse, createFullOpenApiYamlResponse, createOpenApiJsonResponse, createOpenApiYamlResponse, } from './pages/openapi.js';
 import { createPrivacyResponse } from './pages/privacy.js';
@@ -35,6 +36,7 @@ import { registerEmart24Routes } from './api/routes/emart24Routes.js';
 import { registerGs25Routes } from './api/routes/gs25Routes.js';
 import { registerSevenElevenRoutes } from './api/routes/sevenelevenRoutes.js';
 import { registerPlacesRoutes } from './api/routes/placesRoutes.js';
+import { registerCompareRoutes } from './api/routes/compareRoutes.js';
 import { registerHealthRoutes } from './api/routes/healthRoutes.js';
 import { buildConfigStatus } from './api/configStatus.js';
 // 서버 메타데이터
@@ -55,6 +57,7 @@ const createRegistry = (bindings) => {
             zyteApiKey: bindings?.ZYTE_API_KEY,
         }),
         createSevenElevenService,
+        createCompareService,
         () => createPlacesService({
             naverClientId: bindings?.NAVER_CLIENT_ID,
             naverClientSecret: bindings?.NAVER_CLIENT_SECRET,
@@ -195,6 +198,7 @@ app.get('/', (c) => {
             openapi: '/openapi.json (GET) - OpenAI Actions용 축약 OpenAPI',
             openapiFull: '/openapi-full.json (GET) - 전체 OpenAPI',
             actionsQuery: '/api/actions/query (GET) - 기존 GET API 통합 facade',
+            compareProducts: '/api/compare/products (GET) - 키 없는 통합 상품 가격 후보 비교',
         },
         services,
         tools: allTools,
@@ -243,6 +247,7 @@ app.get('/privacy', (c) => {
 registerDaisoRoutes(app);
 registerGs25Routes(app);
 registerSevenElevenRoutes(app);
+registerCompareRoutes(app);
 registerPlacesRoutes(app);
 registerCuRoutes(app);
 registerEmart24Routes(app);

package/dist/pages/openapiFullSpec.js

@@ -11,6 +11,7 @@ import { OPENAPI_PATHS_LOTTECINEMA } from './openapiSpecPathsLottecinema.js';
 import { OPENAPI_PATHS_GS25 } from './openapiSpecPathsGs25.js';
 import { OPENAPI_PATHS_SEVENELEVEN } from './openapiSpecPathsSeveneleven.js';
 import { OPENAPI_PATHS_PLACES } from './openapiSpecPathsPlaces.js';
+import { OPENAPI_PATHS_COMPARE } from './openapiSpecPathsCompare.js';
 import { OPENAPI_COMPONENTS } from './openapiSpecComponents.js';
 export function generateFullOpenApiSpec(baseUrl) {
     return {
@@ -26,6 +27,7 @@ export function generateFullOpenApiSpec(baseUrl) {
 - 🧭 **진열 위치 조회**: 매장 내 상품 구역/층 정보 조회
 - 🏪 **GS25 매장/상품/재고 조회**: GS25 매장 탐색, 상품 검색, 재고 조회
 - 7️⃣ **세븐일레븐 상품/매장/재고 조회**: 상품 검색, 매장 검색, 실재고 조회
+- 🧾 **통합 가격 후보 비교**: 새 외부 키 없이 상품 검색 결과를 묶어 가격 비교
 - 🏪 **CU 매장/재고 조회**: CU 매장 탐색 및 상품 재고 검색
 - 🎬 **메가박스 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
 - 🎞️ **롯데시네마 지점/영화 조회**: 주변 지점, 상영 목록, 잔여 좌석 조회
@@ -51,6 +53,7 @@ export function generateFullOpenApiSpec(baseUrl) {
             ...OPENAPI_PATHS_LOTTEMART,
             ...OPENAPI_PATHS_GS25,
             ...OPENAPI_PATHS_SEVENELEVEN,
+            ...OPENAPI_PATHS_COMPARE,
             ...OPENAPI_PATHS_PLACES,
             ...OPENAPI_PATHS_MEGABOX,
             ...OPENAPI_PATHS_LOTTECINEMA,

package/dist/pages/openapiSpecActions.js

@@ -63,6 +63,13 @@ const ACTION_QUERY_PARAMETERS = [
         description: '주변 장소 카테고리(restaurant, cafe, food, dessert, all)',
         schema: { type: 'string' },
     },
+    {
+        name: 'services',
+        in: 'query',
+        required: false,
+        description: '통합 비교 서비스 목록(daiso,gs25,seveneleven,emart24)',
+        schema: { type: 'string' },
+    },
     {
         name: 'sido',
         in: 'query',

package/dist/pages/openapiSpecPathsCompare.js

@@ -0,0 +1,59 @@
+export const OPENAPI_PATHS_COMPARE = {
+    '/api/compare/products': {
+        get: {
+            operationId: 'compareProducts',
+            summary: '키 없는 통합 상품 가격 후보 비교',
+            description: '새 외부 키 없이 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다.',
+            parameters: [
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: true,
+                    description: '비교할 상품 검색어',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'services',
+                    in: 'query',
+                    required: false,
+                    description: '쉼표로 구분한 서비스 목록(daiso,gs25,seveneleven,emart24)',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '서비스별 최대 결과 수',
+                    schema: { type: 'integer', default: 5, minimum: 1, maximum: 20 },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '통합 상품 가격 후보 비교 결과',
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    success: { type: 'boolean' },
+                                    data: {
+                                        type: 'object',
+                                        properties: {
+                                            keyword: { type: 'string' },
+                                            serviceCount: { type: 'integer' },
+                                            resultCount: { type: 'integer' },
+                                            bestPrice: { type: ['object', 'null'] },
+                                            results: { type: 'array', items: { type: 'object' } },
+                                            errors: { type: 'array', items: { type: 'object' } },
+                                            note: { type: 'string' },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/pages/promptReferenceText.js

@@ -98,7 +98,8 @@ export function buildPromptReferenceText(baseUrl) {
 11. **이마트24 재고 조회**: /api/emart24/inventory는 pluCd + storeKeyword 조합도 지원하므로, 상품 선택 뒤 매장 코드를 다시 모으지 않아도 됩니다.
 12. **올리브영 재고 해석**: inventory.products[].storeInventory.stores[]가 있으면 그 매장별 stockLabel과 remainQuantity를 우선 사용하고, inStock는 그 주변 매장 기준 결과로 해석합니다.
 13. **올리브영 상품 이미지 표시**: /api/oliveyoung/products 또는 oliveyoung_search_products 결과에 imageUrl이 있으면 목록형 답변에서도 각 상품 이미지를 생략하지 말고 모두 렌더링합니다. 특히 \`?l=ko\` 같은 query string을 삭제하지 말고 전체 URL 그대로 마크다운 이미지 src에 넣습니다.
-14. **주변 음식점/카페 검색**: 음식점이나 카페만 물으면 \`places_search_nearby\` 또는 /api/places/search를 먼저 사용합니다. 이 기능은 네이버 지역 검색 기반 키워드 검색이므로 좌표 반경 검색처럼 단정하지 말고, \`searchMode: "keyword"\`임을 필요할 때 짧게 밝혀주세요.
+14. **통합 가격 후보 비교**: 사용자가 브랜드를 특정하지 않고 "어디가 싸?", "비교해줘"처럼 물으면 \`compare_products\` 또는 /api/compare/products를 먼저 사용합니다. 새 외부 키 없이 기존 상품 검색을 묶은 1차 가격 후보이므로 실제 재고/행사가는 각 서비스 상세 조회로 확인해야 합니다.
+15. **주변 음식점/카페 검색**: 음식점이나 카페만 물으면 \`places_search_nearby\` 또는 /api/places/search를 먼저 사용합니다. 이 기능은 네이버 지역 검색 기반 키워드 검색이므로 좌표 반경 검색처럼 단정하지 말고, \`searchMode: "keyword"\`임을 필요할 때 짧게 밝혀주세요.
 
 ---
 
@@ -123,6 +124,7 @@ MCP 연결 정보: ${baseUrl}/mcp
 - seveneleven_check_inventory: 세븐일레븐 재고 조회
 - seveneleven_get_search_popwords: 세븐일레븐 인기 검색어 조회
 - seveneleven_get_catalog_snapshot: 세븐일레븐 카탈로그 조회
+- compare_products: 키 없는 통합 상품 가격 후보 비교
 - places_search_nearby: 음식점/카페 등 주변 장소 검색
 - oliveyoung_search_products: 올리브영 상품 검색
 - oliveyoung_find_nearby_stores: 올리브영 주변 매장 탐색

package/dist/pages/promptRetailCinemaText.js

@@ -2,7 +2,24 @@
  * 프롬프트 리테일/영화 API 섹션
  */
 export function buildPromptRetailCinemaText(baseUrl) {
-    return `### 6-0. 주변 음식점/카페 검색
+    return `### 6-0. 키 없는 통합 상품 가격 후보 비교
+
+**설명**: 새 외부 API 키 없이 기존 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다. 실제 매장 재고와 행사가까지 확정하는 기능이 아니라 "어디가 싸 보이는지"를 빠르게 고르는 1차 검색입니다.
+
+**URL**:
+- ${baseUrl}/api/compare/products?keyword={검색어}
+
+**선택 파라미터**:
+- services: daiso,gs25,seveneleven,emart24 중 쉼표 구분 목록
+- limit: 서비스별 최대 결과 수 (기본값: 5)
+
+**예시**:
+- ${baseUrl}/api/compare/products?keyword=콜라&limit=3
+- ${baseUrl}/api/compare/products?keyword=컵라면&services=seveneleven,emart24
+
+---
+
+### 6-1. 주변 음식점/카페 검색
 
 **설명**: 네이버 지역 검색으로 특정 지역의 음식점, 카페, 디저트 가게 등 주변 장소를 조회합니다. 좌표 반경 검색이 아니라 \`강남역 카페\` 같은 키워드 기반 검색입니다.
 
@@ -23,7 +40,7 @@ export function buildPromptRetailCinemaText(baseUrl) {
 
 ---
 
-### 6-1. 롯데마트 매장/상품 조회
+### 6-2. 롯데마트 매장/상품 조회
 
 **설명**: 롯데마트 계열 매장 검색과 특정 매장 기준 상품 가격/재고 조회를 제공합니다.
 
@@ -49,7 +66,7 @@ export function buildPromptRetailCinemaText(baseUrl) {
 
 ---
 
-### 6-2. GS25 매장/상품/재고 조회
+### 6-3. GS25 매장/상품/재고 조회
 
 **설명**: GS25 매장 탐색, 상품 키워드 검색, 재고 조회를 제공합니다.
 
@@ -73,7 +90,7 @@ export function buildPromptRetailCinemaText(baseUrl) {
 
 ---
 
-### 6-3. 세븐일레븐 상품/매장/재고/인기검색어/카탈로그 조회
+### 6-4. 세븐일레븐 상품/매장/재고/인기검색어/카탈로그 조회
 
 **설명**: 세븐일레븐 상품 검색, 매장 검색, 재고 수량 조회, 인기 검색어, 카탈로그 스냅샷을 제공합니다.
 

package/dist/services/compare/client.js

@@ -0,0 +1,133 @@
+import { fetchProducts as fetchDaisoProducts } from '../daiso/tools/searchProducts.js';
+import { fetchGs25SearchProducts } from '../gs25/client.js';
+import { searchSevenElevenProducts } from '../seveneleven/client.js';
+import { searchEmart24Products } from '../emart24/client.js';
+const DEFAULT_COMPARE_SERVICES = ['daiso', 'gs25', 'seveneleven', 'emart24'];
+const SERVICE_NAMES = {
+    daiso: '다이소',
+    gs25: 'GS25',
+    seveneleven: '세븐일레븐',
+    emart24: '이마트24',
+};
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function parseServices(value) {
+    if (!value || value.trim().length === 0) {
+        return DEFAULT_COMPARE_SERVICES;
+    }
+    const allowed = new Set(DEFAULT_COMPARE_SERVICES);
+    const services = value
+        .split(',')
+        .map((item) => item.trim().toLowerCase())
+        .filter((item) => allowed.has(item));
+    return services.length > 0 ? [...new Set(services)] : DEFAULT_COMPARE_SERVICES;
+}
+function normalizePrice(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null;
+}
+function sortComparableProducts(products) {
+    const serviceOrder = new Map(DEFAULT_COMPARE_SERVICES.map((service, index) => [service, index]));
+    return [...products].sort((a, b) => {
+        if (a.price !== null && b.price !== null && a.price !== b.price) {
+            return a.price - b.price;
+        }
+        if (a.price !== null && b.price === null) {
+            return -1;
+        }
+        if (a.price === null && b.price !== null) {
+            return 1;
+        }
+        return serviceOrder.get(a.service) - serviceOrder.get(b.service);
+    });
+}
+async function searchService(service, keyword, limit) {
+    if (service === 'daiso') {
+        const result = await fetchDaisoProducts(keyword, 1, limit);
+        return result.products.map((product) => ({
+            service,
+            serviceName: SERVICE_NAMES[service],
+            code: product.id,
+            name: product.name,
+            price: normalizePrice(product.price),
+            imageUrl: product.imageUrl,
+            raw: product,
+        }));
+    }
+    if (service === 'gs25') {
+        const products = await fetchGs25SearchProducts(keyword, { timeout: 15000 });
+        return products.slice(0, limit).map((product) => ({
+            service,
+            serviceName: SERVICE_NAMES[service],
+            code: product.itemCode,
+            name: product.itemName || product.shortItemName,
+            price: null,
+            imageUrl: product.imageUrl,
+            stockCheckEnabled: product.stockCheckEnabled,
+            raw: product,
+        }));
+    }
+    if (service === 'seveneleven') {
+        const result = await searchSevenElevenProducts({ query: keyword, page: 1, size: limit });
+        return result.products.map((product) => ({
+            service,
+            serviceName: SERVICE_NAMES[service],
+            code: product.itemCode || product.productNo,
+            name: product.itemName,
+            price: normalizePrice(product.salePrice),
+            originalPrice: normalizePrice(product.originalPrice),
+            imageUrl: product.imageUrl,
+            raw: product,
+        }));
+    }
+    const result = await searchEmart24Products({
+        keyword,
+        page: 1,
+        pageSize: limit,
+        sortType: 'PRICE_ASC',
+        saleProductYn: 'N',
+    });
+    return result.products.map((product) => ({
+        service,
+        serviceName: SERVICE_NAMES[service],
+        code: product.pluCd,
+        name: product.goodsName,
+        price: normalizePrice(product.viewPrice),
+        originalPrice: normalizePrice(product.originPrice),
+        raw: product,
+    }));
+}
+export function parseCompareServices(value) {
+    return parseServices(value);
+}
+export async function compareProducts(params) {
+    const keyword = params.keyword.trim();
+    const limit = Math.max(1, Math.min(Math.trunc(params.limit || 5), 20));
+    const services = params.services && params.services.length > 0 ? params.services : DEFAULT_COMPARE_SERVICES;
+    const settled = await Promise.allSettled(services.map(async (service) => ({
+        service,
+        products: await searchService(service, keyword, limit),
+    })));
+    const results = [];
+    const errors = [];
+    for (const item of settled) {
+        if (item.status === 'fulfilled') {
+            results.push(...item.value.products);
+        }
+        else {
+            const service = services[settled.indexOf(item)];
+            errors.push({ service, message: toErrorMessage(item.reason) });
+        }
+    }
+    const sorted = sortComparableProducts(results);
+    return {
+        keyword,
+        services,
+        serviceCount: services.length,
+        resultCount: sorted.length,
+        bestPrice: sorted.find((product) => product.price !== null) || null,
+        results: sorted,
+        errors,
+        note: '새 외부 키 없이 기존 공개 상품 검색을 묶은 가격 후보입니다. 실제 재고와 행사가는 매장별로 달라질 수 있습니다.',
+    };
+}

package/dist/services/compare/index.js

@@ -0,0 +1,17 @@
+import { createCompareProductsTool } from './tools/compareProducts.js';
+const COMPARE_METADATA = {
+    id: 'compare',
+    name: '통합 비교',
+    version: '1.0.0',
+    description: '새 외부 키 없이 기존 상품 검색을 묶어 가격 후보를 비교하는 서비스',
+};
+class CompareService {
+    metadata = COMPARE_METADATA;
+    getTools() {
+        return [createCompareProductsTool()];
+    }
+}
+export function createCompareService() {
+    return new CompareService();
+}
+export * from './types.js';

package/dist/services/compare/tools/compareProducts.js

@@ -0,0 +1,45 @@
+import * as z from 'zod';
+import { compareProducts, parseCompareServices } from '../client.js';
+async function compareProductsHandler(args) {
+    const keyword = args.keyword?.trim();
+    if (!keyword) {
+        throw new Error('검색어(keyword)를 입력해주세요.');
+    }
+    const result = await compareProducts({
+        keyword,
+        limit: args.limit,
+        services: parseCompareServices(args.services),
+    });
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        structuredContent: { ...result },
+    };
+}
+export function createCompareProductsTool() {
+    return {
+        name: 'compare_products',
+        metadata: {
+            title: '가격 후보 통합 비교',
+            description: '새 외부 키 없이 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다.',
+            inputSchema: {
+                keyword: z.string().describe('비교할 상품 검색어'),
+                limit: z.number().optional().default(5).describe('서비스별 최대 결과 수'),
+                services: z
+                    .string()
+                    .optional()
+                    .describe('쉼표로 구분한 서비스 목록(daiso,gs25,seveneleven,emart24)'),
+            },
+            outputSchema: {
+                keyword: z.string().optional(),
+                services: z.array(z.string()).optional(),
+                serviceCount: z.number().optional(),
+                resultCount: z.number().optional(),
+                bestPrice: z.unknown().optional(),
+                results: z.array(z.unknown()).optional(),
+                errors: z.array(z.unknown()).optional(),
+                note: z.string().optional(),
+            },
+        },
+        handler: compareProductsHandler,
+    };
+}

package/dist/services/compare/types.js

@@ -0,0 +1 @@
+export {};

package/openapi.json

@@ -53,6 +53,7 @@
                 "sevenelevenCheckInventory",
                 "sevenelevenGetPopwords",
                 "sevenelevenGetCatalog",
+                "compareProducts",
                 "placesSearchNearby",
                 "megaboxFindTheaters",
                 "megaboxListMovies",
@@ -129,6 +130,15 @@
               "type": "string"
             }
           },
+          {
+            "name": "services",
+            "in": "query",
+            "required": false,
+            "description": "통합 비교 서비스 목록(daiso,gs25,seveneleven,emart24)",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "sido",
             "in": "query",

package/openapi.yaml

@@ -54,6 +54,7 @@ paths:
               - sevenelevenCheckInventory
               - sevenelevenGetPopwords
               - sevenelevenGetCatalog
+              - compareProducts
               - placesSearchNearby
               - megaboxFindTheaters
               - megaboxListMovies
@@ -106,6 +107,12 @@ paths:
           description: 주변 장소 카테고리(restaurant, cafe, food, dessert, all)
           schema:
             type: string
+        - name: services
+          in: query
+          required: false
+          description: 통합 비교 서비스 목록(daiso,gs25,seveneleven,emart24)
+          schema:
+            type: string
         - name: sido
           in: query
           required: false

package/package.json

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