daiso 1.0.4 → 1.0.6

package/dist/cli.js

@@ -4,135 +4,39 @@
  *
  * npx daiso 명령으로 원격 MCP 서버 정보를 확인하고 상태를 점검합니다.
  */
-import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { spawn } from 'node:child_process';
-import { printCommandHelp, printHelp } from './cliHelp.js';
-import { renderApiEnvelope } from './cliRenderer.js';
-const DEFAULT_BASE_URL = 'https://mcp.aka.page';
-const DEFAULT_MCP_URL = `${DEFAULT_BASE_URL}/mcp`;
-function loadVersion() {
-    const cliPath = fileURLToPath(import.meta.url);
-    const packagePath = path.resolve(path.dirname(cliPath), '../package.json');
-    if (!existsSync(packagePath)) {
-        return '0.0.0';
-    }
-    const raw = readFileSync(packagePath, 'utf8');
-    const parsed = JSON.parse(raw);
-    return parsed.version ?? '0.0.0';
-}
-async function execCommand(command, args) {
-    return await new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-            stdio: 'inherit',
-            shell: false,
-        });
-        child.on('error', (error) => {
-            reject(error);
-        });
-        child.on('close', (code) => {
-            resolve(code ?? 1);
-        });
-    });
-}
-function createDefaultDeps() {
-    return {
-        fetchImpl: fetch,
-        writeOut: (message) => {
-            process.stdout.write(`${message}\n`);
-        },
-        writeErr: (message) => {
-            process.stderr.write(`${message}\n`);
-        },
-        getVersion: loadVersion,
-        nowIso: () => new Date().toISOString(),
-        runCommand: execCommand,
-    };
-}
-function parseCliArgs(args) {
-    const positionals = [];
-    const options = {};
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (!token.startsWith('--')) {
-            positionals.push(token);
-            continue;
-        }
-        const withoutPrefix = token.slice(2);
-        const equalIndex = withoutPrefix.indexOf('=');
-        if (equalIndex >= 0) {
-            const key = withoutPrefix.slice(0, equalIndex);
-            const value = withoutPrefix.slice(equalIndex + 1);
-            options[key] = value;
-            continue;
-        }
-        const key = withoutPrefix;
-        const nextValue = args[index + 1];
-        if (!nextValue || nextValue.startsWith('--')) {
-            options[key] = 'true';
-            continue;
-        }
-        options[key] = nextValue;
-        index += 1;
-    }
-    return { positionals, options };
-}
-function toUrl(pathOrUrl) {
-    if (pathOrUrl.startsWith('http://') || pathOrUrl.startsWith('https://')) {
-        return new URL(pathOrUrl);
-    }
-    const normalizedPath = pathOrUrl.startsWith('/') ? pathOrUrl : `/${pathOrUrl}`;
-    return new URL(normalizedPath, DEFAULT_BASE_URL);
-}
-function applyOptionsToQuery(url, options) {
-    for (const [key, value] of Object.entries(options)) {
-        url.searchParams.set(key, value);
-    }
-}
-function toQueryOptions(options) {
-    const queryOptions = {};
-    for (const [key, value] of Object.entries(options)) {
-        if (key === 'help' || key === 'json') {
-            continue;
-        }
-        queryOptions[key] = value;
-    }
-    return queryOptions;
-}
-async function requestAndPrintResponse(fetchImpl, writeOut, writeErr, url, command, asJson) {
-    try {
-        const response = await fetchImpl(url.toString());
-        if (!response.ok) {
-            const bodyText = await response.text();
-            writeErr(`요청 실패: HTTP ${response.status}`);
-            if (bodyText) {
-                writeErr(bodyText);
-            }
-            return 1;
-        }
-        const payload = (await response.json());
-        if (asJson) {
-            writeOut(JSON.stringify(payload, null, 2));
-        }
-        else {
-            writeOut(renderApiEnvelope(command, url, payload));
-        }
-        return 0;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        writeErr(`요청 중 오류 발생: ${message}`);
-        return 1;
-    }
+import { printHelp, printCommandHelp } from './cliHelp.js';
+import { createDefaultDeps } from './cli/deps.js';
+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, 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);
 }
 export async function runCli(argv, deps) {
     const resolvedDeps = {
         ...createDefaultDeps(),
         ...deps,
     };
-    const [command, ...options] = argv;
-    if (!command || command === 'help' || command === '--help' || command === '-h') {
+    const nonInteractive = argv.includes('--non-interactive');
+    const normalizedArgv = argv.filter((arg) => arg !== '--non-interactive');
+    const [command, ...options] = normalizedArgv;
+    if (!command) {
+        if (!nonInteractive && resolvedDeps.isInteractiveTerminal()) {
+            return await resolvedDeps.runInteractive({
+                fetchImpl: resolvedDeps.fetchImpl,
+                writeOut: resolvedDeps.writeOut,
+                writeErr: resolvedDeps.writeErr,
+            });
+        }
+        printHelp(resolvedDeps.writeOut);
+        return 0;
+    }
+    if (command === 'help' || command === '--help' || command === '-h') {
         const maybeCommand = options[0];
         if (maybeCommand) {
             return printCommandHelp(maybeCommand, resolvedDeps.writeOut, resolvedDeps.writeErr);
@@ -141,14 +45,23 @@ export async function runCli(argv, deps) {
         return 0;
     }
     if (command === 'version' || command === '--version' || command === '-v') {
+        if (rejectTopLevelUnknownOptions(options, 'version', resolvedDeps)) {
+            return 1;
+        }
         resolvedDeps.writeOut(resolvedDeps.getVersion());
         return 0;
     }
     if (command === 'url') {
+        if (rejectTopLevelUnknownOptions(options, 'url', resolvedDeps)) {
+            return 1;
+        }
         resolvedDeps.writeOut(DEFAULT_MCP_URL);
         return 0;
     }
     if (command === 'health') {
+        if (rejectTopLevelUnknownOptions(options, 'health', resolvedDeps)) {
+            return 1;
+        }
         try {
             const response = await resolvedDeps.fetchImpl(`${DEFAULT_BASE_URL}/health`);
             if (!response.ok) {
@@ -170,6 +83,9 @@ export async function runCli(argv, deps) {
         }
     }
     if (command === 'claude') {
+        if (rejectTopLevelUnknownOptions(options, 'claude', resolvedDeps)) {
+            return 1;
+        }
         const cliArgs = ['mcp', 'add', 'daiso', DEFAULT_BASE_URL, '--transport', 'sse'];
         if (options.includes('--exec')) {
             try {
@@ -184,82 +100,57 @@ export async function runCli(argv, deps) {
         resolvedDeps.writeOut(`claude ${cliArgs.join(' ')}`);
         return 0;
     }
-    if (command === 'get') {
-        const parsed = parseCliArgs(options);
-        if (parsed.options.help === 'true') {
-            return printCommandHelp('get', resolvedDeps.writeOut, resolvedDeps.writeErr);
-        }
-        const targetPath = parsed.positionals[0];
-        if (!targetPath) {
-            resolvedDeps.writeErr('get 명령은 경로가 필요합니다. 예: daiso get /api/daiso/products --q 수납박스');
-            return 1;
-        }
-        const targetUrl = toUrl(targetPath);
-        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
-        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
-    }
-    if (command === 'products') {
-        const parsed = parseCliArgs(options);
-        if (parsed.options.help === 'true') {
-            return printCommandHelp('products', resolvedDeps.writeOut, resolvedDeps.writeErr);
-        }
-        const query = parsed.positionals[0];
-        if (!query) {
-            resolvedDeps.writeErr('products 명령은 검색어가 필요합니다. 예: daiso products 수납박스');
-            return 1;
-        }
-        const targetUrl = toUrl('/api/daiso/products');
-        targetUrl.searchParams.set('q', query);
-        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
-        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
-    }
-    if (command === 'product') {
-        const parsed = parseCliArgs(options);
-        if (parsed.options.help === 'true') {
-            return printCommandHelp('product', resolvedDeps.writeOut, resolvedDeps.writeErr);
-        }
-        const productId = parsed.positionals[0];
-        if (!productId) {
-            resolvedDeps.writeErr('product 명령은 제품 ID가 필요합니다. 예: daiso product 1034604');
-            return 1;
-        }
-        const targetUrl = toUrl(`/api/daiso/products/${productId}`);
-        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
-        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
-    }
-    if (command === 'stores') {
-        const parsed = parseCliArgs(options);
-        if (parsed.options.help === 'true') {
-            return printCommandHelp('stores', resolvedDeps.writeOut, resolvedDeps.writeErr);
-        }
-        const keyword = parsed.positionals[0];
-        if (keyword) {
-            parsed.options.keyword = keyword;
-        }
-        if (!parsed.options.keyword && !parsed.options.sido) {
-            resolvedDeps.writeErr('stores 명령은 keyword 또는 --sido가 필요합니다. 예: daiso stores 강남역 / daiso stores --sido 서울');
-            return 1;
-        }
-        const targetUrl = toUrl('/api/daiso/stores');
-        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
-        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
-    }
-    if (command === 'inventory') {
-        const parsed = parseCliArgs(options);
-        if (parsed.options.help === 'true') {
-            return printCommandHelp('inventory', resolvedDeps.writeOut, resolvedDeps.writeErr);
-        }
-        const productId = parsed.positionals[0];
-        if (!productId) {
-            resolvedDeps.writeErr('inventory 명령은 제품 ID가 필요합니다. 예: daiso inventory 1034604 --keyword 강남역');
-            return 1;
-        }
-        const targetUrl = toUrl('/api/daiso/inventory');
-        targetUrl.searchParams.set('productId', productId);
-        applyOptionsToQuery(targetUrl, toQueryOptions(parsed.options));
-        return await requestAndPrintResponse(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl, command, parsed.options.json === 'true');
-    }
+    if (command === 'get')
+        return await handleGet(options, resolvedDeps);
+    if (command === 'products')
+        return await handleProducts(options, resolvedDeps);
+    if (command === 'product')
+        return await handleProduct(options, resolvedDeps);
+    if (command === 'stores')
+        return await handleStores(options, resolvedDeps);
+    if (command === 'inventory')
+        return await handleInventory(options, resolvedDeps);
+    if (command === 'display-location')
+        return await handleDisplayLocation(options, resolvedDeps);
+    if (command === 'cu-stores')
+        return await handleCuStores(options, resolvedDeps);
+    if (command === 'cu-inventory')
+        return await handleCuInventory(options, resolvedDeps);
+    if (command === 'lottecinema-theaters')
+        return await handleLottecinemaTheaters(options, resolvedDeps);
+    if (command === 'lottecinema-movies')
+        return await handleLottecinemaMovies(options, resolvedDeps);
+    if (command === 'lottecinema-seats')
+        return await handleLottecinemaSeats(options, resolvedDeps);
+    if (command === 'emart24-stores')
+        return await handleEmart24Stores(options, resolvedDeps);
+    if (command === 'emart24-products')
+        return await handleEmart24Products(options, resolvedDeps);
+    if (command === 'emart24-inventory')
+        return await handleEmart24Inventory(options, resolvedDeps);
+    if (command === 'lottemart-stores')
+        return await handleLotteMartStores(options, resolvedDeps);
+    if (command === 'lottemart-products')
+        return await handleLotteMartProducts(options, resolvedDeps);
+    if (command === 'gs25-stores')
+        return await handleGs25Stores(options, resolvedDeps);
+    if (command === 'gs25-products')
+        return await handleGs25Products(options, resolvedDeps);
+    if (command === 'gs25-inventory')
+        return await handleGs25Inventory(options, resolvedDeps);
+    if (command === 'seveneleven-products')
+        return await handleSevenElevenProducts(options, resolvedDeps);
+    if (command === 'seveneleven-stores')
+        return await handleSevenElevenStores(options, resolvedDeps);
+    if (command === 'seveneleven-popwords')
+        return await handleSevenElevenPopwords(options, resolvedDeps);
+    if (command === 'seveneleven-catalog')
+        return await handleSevenElevenCatalog(options, resolvedDeps);
     resolvedDeps.writeErr(`알 수 없는 명령어: ${command}`);
+    if (command === 'search') {
+        const query = options[0] ?? '<검색어>';
+        resolvedDeps.writeErr(`혹시 찾으신 명령: daiso products ${query}`);
+    }
     resolvedDeps.writeErr('도움말: daiso help');
     return 1;
 }

package/dist/cliHelp.js

@@ -12,6 +12,24 @@ export const COMMAND_LIST = [
     'product',
     'stores',
     'inventory',
+    'display-location',
+    'cu-stores',
+    'cu-inventory',
+    'lottecinema-theaters',
+    'lottecinema-movies',
+    'lottecinema-seats',
+    'lottemart-stores',
+    'lottemart-products',
+    'emart24-stores',
+    'emart24-products',
+    'emart24-inventory',
+    'gs25-stores',
+    'gs25-products',
+    'gs25-inventory',
+    'seveneleven-products',
+    'seveneleven-stores',
+    'seveneleven-popwords',
+    'seveneleven-catalog',
 ];
 const COMMAND_SUMMARY = {
     help: '도움말 출력',
@@ -24,6 +42,24 @@ const COMMAND_SUMMARY = {
     product: '다이소 제품 상세 조회',
     stores: '다이소 매장 검색',
     inventory: '다이소 재고 조회',
+    'display-location': '다이소 진열 위치 조회',
+    'cu-stores': 'CU 매장 검색',
+    'cu-inventory': 'CU 재고 조회',
+    'lottecinema-theaters': '롯데시네마 주변 지점 조회',
+    'lottecinema-movies': '롯데시네마 영화/회차 조회',
+    'lottecinema-seats': '롯데시네마 잔여 좌석 조회',
+    'lottemart-stores': '롯데마트 매장 검색',
+    'lottemart-products': '롯데마트 상품 검색',
+    'emart24-stores': '이마트24 매장 검색',
+    'emart24-products': '이마트24 상품 검색',
+    'emart24-inventory': '이마트24 재고 조회',
+    'gs25-stores': 'GS25 매장 검색',
+    'gs25-products': 'GS25 상품 검색',
+    'gs25-inventory': 'GS25 재고 조회',
+    'seveneleven-products': '세븐일레븐 상품 검색',
+    'seveneleven-stores': '세븐일레븐 매장 검색',
+    'seveneleven-popwords': '세븐일레븐 인기 검색어 조회',
+    'seveneleven-catalog': '세븐일레븐 카탈로그 스냅샷 조회',
 };
 const COMMAND_DETAIL = {
     help: [
@@ -97,12 +133,163 @@ const COMMAND_DETAIL = {
         '옵션: --keyword, --lat, --lng, --page, --pageSize, --json',
         '예시: daiso inventory 1034604 --keyword 강남역',
     ],
+    'display-location': [
+        '명령: display-location',
+        '설명: 다이소 매장 내 상품 진열 위치 API를 호출합니다.',
+        '사용법: daiso display-location <productId> <storeCode> [--json]',
+        '필수: <productId>, <storeCode>',
+        '옵션: --json',
+        '예시: daiso display-location 1034604 04515',
+    ],
+    'cu-stores': [
+        '명령: cu-stores',
+        '설명: CU 매장 검색 API를 호출합니다.',
+        '사용법: daiso cu-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso cu-stores 강남',
+        '예시: daiso cu-stores --lat 37.498 --lng 127.027 --limit 10',
+    ],
+    'cu-inventory': [
+        '명령: cu-inventory',
+        '설명: CU 재고 검색 API를 호출합니다.',
+        '사용법: daiso cu-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--size N] [--offset N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --size, --offset, --searchSort, --storeLimit, --json',
+        '예시: daiso cu-inventory 과자',
+        '예시: daiso cu-inventory 컵라면 --storeKeyword 강남 --size 10',
+    ],
+    'lottecinema-theaters': [
+        '명령: lottecinema-theaters',
+        '설명: 롯데시네마 주변 지점 API를 호출합니다.',
+        '사용법: daiso lottecinema-theaters [keyword] [--lat 값] [--lng 값] [--playDate YYYYMMDD] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --playDate, --limit, --json',
+        '예시: daiso lottecinema-theaters 잠실 --limit 5',
+        '예시: daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5',
+    ],
+    'lottecinema-movies': [
+        '명령: lottecinema-movies',
+        '설명: 롯데시네마 영화/회차 API를 호출합니다.',
+        '사용법: daiso lottecinema-movies [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --json',
+        '예시: daiso lottecinema-movies 잠실 --playDate 20260310',
+        '예시: daiso lottecinema-movies --playDate 20260310 --keyword "안산 중앙역"',
+    ],
+    'lottecinema-seats': [
+        '명령: lottecinema-seats',
+        '설명: 롯데시네마 잔여 좌석 API를 호출합니다.',
+        '사용법: daiso lottecinema-seats [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso lottecinema-seats 잠실 --playDate 20260310 --movieId 23816',
+        '예시: daiso lottecinema-seats --playDate 20260310 --keyword "안산 중앙역" --movieId 23816',
+    ],
+    'lottemart-stores': [
+        '명령: lottemart-stores',
+        '설명: 롯데마트 계열 매장 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-stores [keyword] [--area 값] [--brandVariant 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --area, --brandVariant, --lat, --lng, --limit, --json',
+        '예시: daiso lottemart-stores 잠실 --area 서울',
+        '예시: daiso lottemart-stores --area 경기 --brandVariant lottemart --limit 10',
+    ],
+    'lottemart-products': [
+        '명령: lottemart-products',
+        '설명: 롯데마트 매장 기준 상품 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-products <keyword> [--storeCode 값 | --storeName 값] [--area 값] [--pageLimit N] [--json]',
+        '필수: <keyword>, --storeCode 또는 --storeName',
+        '옵션: --storeCode, --storeName, --area, --pageLimit, --json',
+        '예시: daiso lottemart-products 콜라 --storeName 강변점 --area 서울',
+        '예시: daiso lottemart-products 우유 --storeCode 2301 --pageLimit 2',
+    ],
+    'emart24-stores': [
+        '명령: emart24-stores',
+        '설명: 이마트24 매장 검색 API를 호출합니다.',
+        '사용법: daiso emart24-stores [keyword] [--area1 값] [--area2 값] [--lat 값] [--lng 값] [--service24h true|false] [--limit N] [--json]',
+        '옵션: --keyword, --area1, --area2, --lat, --lng, --service24h, --limit, --json',
+        '예시: daiso emart24-stores 강남',
+        '예시: daiso emart24-stores --area1 서울특별시 --area2 강남구 --service24h true',
+    ],
+    'emart24-products': [
+        '명령: emart24-products',
+        '설명: 이마트24 상품 검색 API를 호출합니다.',
+        '사용법: daiso emart24-products <keyword> [--page N] [--pageSize N] [--sortType 값] [--saleProductYn Y|N] [--json]',
+        '필수: <keyword>',
+        '옵션: --page, --pageSize, --sortType, --saleProductYn, --json',
+        '예시: daiso emart24-products 두바이',
+        '예시: daiso emart24-products 도시락 --page 2 --pageSize 20',
+    ],
+    'emart24-inventory': [
+        '명령: emart24-inventory',
+        '설명: 이마트24 매장별 재고 API를 호출합니다.',
+        '사용법: daiso emart24-inventory <pluCd> --bizNoArr 코드1,코드2 [--json]',
+        '필수: <pluCd>, --bizNoArr',
+        '옵션: --bizNoArr, --json',
+        '예시: daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015,23233',
+    ],
+    'gs25-stores': [
+        '명령: gs25-stores',
+        '설명: GS25 매장 검색 API를 호출합니다.',
+        '사용법: daiso gs25-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --serviceCode, --limit, --json',
+        '예시: daiso gs25-stores 강남',
+        '예시: daiso gs25-stores --lat 37.4982 --lng 127.0276 --limit 10',
+    ],
+    'gs25-products': [
+        '명령: gs25-products',
+        '설명: GS25 상품 키워드 검색 API를 호출합니다.',
+        '사용법: daiso gs25-products <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --serviceCode, --limit, --json',
+        '예시: daiso gs25-products 오감자',
+    ],
+    'gs25-inventory': [
+        '명령: gs25-inventory',
+        '설명: GS25 재고 검색 API를 호출합니다.',
+        '사용법: daiso gs25-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--storeLimit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --serviceCode, --storeLimit, --json',
+        '예시: daiso gs25-inventory 오감자 --storeKeyword 강남',
+    ],
+    'seveneleven-products': [
+        '명령: seveneleven-products',
+        '설명: 세븐일레븐 상품 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-products <query> [--page N] [--size N] [--sort 값] [--json]',
+        '필수: <query>',
+        '옵션: --page, --size, --sort, --json',
+        '예시: daiso seveneleven-products 삼각김밥 --size 20',
+    ],
+    'seveneleven-stores': [
+        '명령: seveneleven-stores',
+        '설명: 세븐일레븐 매장 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-stores <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --limit, --json',
+        '예시: daiso seveneleven-stores 안산 중앙역 --limit 10',
+    ],
+    'seveneleven-popwords': [
+        '명령: seveneleven-popwords',
+        '설명: 세븐일레븐 인기 검색어 API를 호출합니다.',
+        '사용법: daiso seveneleven-popwords [--label 값] [--json]',
+        '옵션: --label, --json',
+        '예시: daiso seveneleven-popwords --label home',
+    ],
+    'seveneleven-catalog': [
+        '명령: seveneleven-catalog',
+        '설명: 세븐일레븐 카탈로그 스냅샷 API를 호출합니다.',
+        '사용법: daiso seveneleven-catalog [--includeIssues true|false] [--includeExhibition true|false] [--limit N] [--json]',
+        '옵션: --includeIssues, --includeExhibition, --limit, --json',
+        '예시: daiso seveneleven-catalog --includeIssues true --includeExhibition true --limit 10',
+    ],
 };
 export function printHelp(writeOut) {
     writeOut('daiso CLI');
     writeOut('');
+    writeOut('기본 실행:');
+    writeOut('  npx daiso (인터랙티브 모드)');
+    writeOut('  npx daiso --non-interactive (도움말 출력)');
+    writeOut('');
     writeOut('사용법:');
     writeOut('  daiso <command> [options]');
+    writeOut('전역 옵션:');
+    writeOut('  --non-interactive  인터랙티브 진입 비활성화');
     writeOut('');
     writeOut('명령어:');
     for (const command of COMMAND_LIST) {
@@ -116,15 +303,39 @@ export function printHelp(writeOut) {
     writeOut('  npx daiso products 수납박스');
     writeOut('  npx daiso stores 강남역');
     writeOut('  npx daiso inventory 1034604 --keyword 강남역');
+    writeOut('  npx daiso display-location 1034604 04515');
+    writeOut('  npx daiso cu-stores 강남');
+    writeOut('  npx daiso cu-inventory 과자 --storeKeyword 강남');
+    writeOut('  npx daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5');
+    writeOut('  npx daiso lottecinema-movies --playDate 20260310 --keyword "안산 중앙역"');
+    writeOut('  npx daiso lottecinema-seats --playDate 20260310 --keyword "안산 중앙역" --movieId 23816');
+    writeOut('  npx daiso lottemart-stores 잠실 --area 서울 --limit 10');
+    writeOut('  npx daiso lottemart-products 콜라 --storeName 강변점 --area 서울');
+    writeOut('  npx daiso emart24-stores 강남 --limit 10');
+    writeOut('  npx daiso emart24-products 두바이 --pageSize 20');
+    writeOut('  npx daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015');
+    writeOut('  npx daiso gs25-stores 강남 --limit 10');
+    writeOut('  npx daiso gs25-products 오감자');
+    writeOut('  npx daiso gs25-inventory 오감자 --storeKeyword 강남');
+    writeOut('  npx daiso seveneleven-products 삼각김밥 --size 20');
+    writeOut('  npx daiso seveneleven-stores 안산 중앙역 --limit 10');
+    writeOut('  npx daiso seveneleven-popwords --label home');
+    writeOut('  npx daiso seveneleven-catalog --limit 10');
     writeOut('  npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056');
     writeOut('');
+    writeOut('정보가 부족할 때:');
+    writeOut('  제품명을 먼저 검색해 productId를 확인: npx daiso products 수납박스');
+    writeOut('  productId로 재고 확인: npx daiso inventory <productId> --keyword 강남역');
+    writeOut('  매장을 먼저 검색해 storeName 또는 storeCode를 확인: npx daiso stores 강남역');
+    writeOut('  롯데마트 매장 확인: npx daiso lottemart-stores 잠실 --area 서울');
+    writeOut('');
     writeOut('상세 도움말:');
     writeOut('  npx daiso help <command>');
 }
 export function printCommandHelp(command, writeOut, writeErr) {
     if (!Object.hasOwn(COMMAND_DETAIL, command)) {
         writeErr(`도움말을 찾을 수 없는 명령어: ${command}`);
-        writeErr('사용 가능한 명령어: help, version, url, health, claude, get, products, product, stores, inventory');
+        writeErr('사용 가능한 명령어: help, version, url, health, claude, get, products, product, stores, inventory, display-location, cu-stores, cu-inventory, lottecinema-theaters, lottecinema-movies, lottecinema-seats, lottemart-stores, lottemart-products, emart24-stores, emart24-products, emart24-inventory, gs25-stores, gs25-products, gs25-inventory, seveneleven-products, seveneleven-stores, seveneleven-popwords, seveneleven-catalog');
         return 1;
     }
     const detail = COMMAND_DETAIL[command];