daiso 1.0.1 → 1.0.3

package/README.md

@@ -41,9 +41,17 @@ CLI (npx):
 
 ```bash
 npx daiso help
+npx daiso help products
 npx daiso url
 npx daiso health
 npx daiso claude
+
+# AI 없이 직접 조회
+npx daiso products 수납박스
+npx daiso product 1034604
+npx daiso stores 강남역
+npx daiso inventory 1034604 --keyword 강남역
+npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056
 ```
 
 <br>

package/dist/cli.js

@@ -8,6 +8,7 @@ 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';
 const DEFAULT_BASE_URL = 'https://mcp.aka.page';
 const DEFAULT_MCP_URL = `${DEFAULT_BASE_URL}/mcp`;
 function loadVersion() {
@@ -20,25 +21,6 @@ function loadVersion() {
     const parsed = JSON.parse(raw);
     return parsed.version ?? '0.0.0';
 }
-function printHelp(writeOut) {
-    writeOut('daiso CLI');
-    writeOut('');
-    writeOut('사용법:');
-    writeOut('  daiso <command> [options]');
-    writeOut('');
-    writeOut('명령어:');
-    writeOut('  help                 도움말 출력');
-    writeOut('  version              CLI 버전 출력');
-    writeOut('  url                  MCP 엔드포인트 URL 출력');
-    writeOut('  health               원격 서버 상태 확인');
-    writeOut('  claude               Claude Code MCP 등록 명령 출력');
-    writeOut('  claude --exec        Claude Code MCP 등록 명령 실행');
-    writeOut('');
-    writeOut('예시:');
-    writeOut('  npx daiso url');
-    writeOut('  npx daiso health');
-    writeOut('  npx daiso claude');
-}
 async function execCommand(command, args) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -67,6 +49,67 @@ function createDefaultDeps() {
         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);
+    }
+}
+async function requestAndPrintJson(fetchImpl, writeOut, writeErr, url) {
+    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());
+        writeOut(JSON.stringify(payload, null, 2));
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writeErr(`요청 중 오류 발생: ${message}`);
+        return 1;
+    }
+}
 export async function runCli(argv, deps) {
     const resolvedDeps = {
         ...createDefaultDeps(),
@@ -74,6 +117,10 @@ export async function runCli(argv, deps) {
     };
     const [command, ...options] = argv;
     if (!command || command === 'help' || command === '--help' || command === '-h') {
+        const maybeCommand = options[0];
+        if (maybeCommand) {
+            return printCommandHelp(maybeCommand, resolvedDeps.writeOut, resolvedDeps.writeErr);
+        }
         printHelp(resolvedDeps.writeOut);
         return 0;
     }
@@ -121,6 +168,81 @@ 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, parsed.options);
+        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+    }
+    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, parsed.options);
+        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+    }
+    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, parsed.options);
+        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+    }
+    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, parsed.options);
+        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+    }
+    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, parsed.options);
+        return await requestAndPrintJson(resolvedDeps.fetchImpl, resolvedDeps.writeOut, resolvedDeps.writeErr, targetUrl);
+    }
     resolvedDeps.writeErr(`알 수 없는 명령어: ${command}`);
     resolvedDeps.writeErr('도움말: daiso help');
     return 1;

package/dist/cliHelp.js

@@ -0,0 +1,133 @@
+/**
+ * CLI 도움말 정의
+ */
+export const COMMAND_LIST = [
+    'help',
+    'version',
+    'url',
+    'health',
+    'claude',
+    'get',
+    'products',
+    'product',
+    'stores',
+    'inventory',
+];
+const COMMAND_SUMMARY = {
+    help: '도움말 출력',
+    version: 'CLI 버전 출력',
+    url: 'MCP 엔드포인트 URL 출력',
+    health: '원격 서버 상태 확인',
+    claude: 'Claude Code MCP 등록 명령 출력/실행',
+    get: '임의 API 경로 GET 호출',
+    products: '다이소 제품 검색',
+    product: '다이소 제품 상세 조회',
+    stores: '다이소 매장 검색',
+    inventory: '다이소 재고 조회',
+};
+const COMMAND_DETAIL = {
+    help: [
+        '명령: help',
+        '설명: 전체 도움말 또는 특정 명령 상세 도움말을 출력합니다.',
+        '사용법: daiso help [command]',
+        '예시: daiso help products',
+    ],
+    version: [
+        '명령: version',
+        '설명: 설치된 daiso CLI 버전을 출력합니다.',
+        '사용법: daiso version',
+    ],
+    url: [
+        '명령: url',
+        '설명: MCP 엔드포인트 URL을 출력합니다.',
+        '사용법: daiso url',
+        '출력 예시: https://mcp.aka.page/mcp',
+    ],
+    health: [
+        '명령: health',
+        '설명: 서버 /health API를 호출해 상태를 확인합니다.',
+        '사용법: daiso health',
+        '출력: status, endpoint, checkedAt(JSON)',
+    ],
+    claude: [
+        '명령: claude',
+        '설명: Claude Code MCP 등록 명령을 출력하거나 실행합니다.',
+        '사용법: daiso claude [--exec]',
+        '옵션: --exec 실제 claude 명령 실행',
+        '예시: daiso claude --exec',
+    ],
+    get: [
+        '명령: get',
+        '설명: 임의 API 경로를 GET으로 호출합니다.',
+        '사용법: daiso get <path|url> [--queryKey value ...]',
+        '필수: <path|url>',
+        '예시: daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056',
+    ],
+    products: [
+        '명령: products',
+        '설명: 다이소 제품 검색 API를 호출합니다.',
+        '사용법: daiso products <query> [--page N] [--pageSize N]',
+        '필수: <query>',
+        '옵션: --page, --pageSize',
+        '예시: daiso products 수납박스 --page 1 --pageSize 30',
+    ],
+    product: [
+        '명령: product',
+        '설명: 다이소 제품 상세 API를 호출합니다.',
+        '사용법: daiso product <productId>',
+        '필수: <productId>',
+        '예시: daiso product 1034604',
+    ],
+    stores: [
+        '명령: stores',
+        '설명: 다이소 매장 검색 API를 호출합니다.',
+        '사용법: daiso stores [keyword] [--sido 값] [--gugun 값] [--dong 값] [--limit N]',
+        '필수: keyword 또는 --sido',
+        '옵션: --keyword, --sido, --gugun, --dong, --limit',
+        '예시: daiso stores 강남역',
+        '예시: daiso stores --sido 서울 --gugun 강남구',
+    ],
+    inventory: [
+        '명령: inventory',
+        '설명: 다이소 재고 API를 호출합니다.',
+        '사용법: daiso inventory <productId> [--keyword 값] [--lat 값] [--lng 값] [--page N] [--pageSize N]',
+        '필수: <productId>',
+        '옵션: --keyword, --lat, --lng, --page, --pageSize',
+        '예시: daiso inventory 1034604 --keyword 강남역',
+    ],
+};
+export function printHelp(writeOut) {
+    writeOut('daiso CLI');
+    writeOut('');
+    writeOut('사용법:');
+    writeOut('  daiso <command> [options]');
+    writeOut('');
+    writeOut('명령어:');
+    for (const command of COMMAND_LIST) {
+        writeOut(`  ${command.padEnd(20, ' ')}${COMMAND_SUMMARY[command]}`);
+    }
+    writeOut('');
+    writeOut('예시:');
+    writeOut('  npx daiso url');
+    writeOut('  npx daiso health');
+    writeOut('  npx daiso claude');
+    writeOut('  npx daiso products 수납박스');
+    writeOut('  npx daiso stores 강남역');
+    writeOut('  npx daiso inventory 1034604 --keyword 강남역');
+    writeOut('  npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056');
+    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');
+        return 1;
+    }
+    const detail = COMMAND_DETAIL[command];
+    for (const line of detail) {
+        writeOut(line);
+    }
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Daiso MCP Server for mobile access via Cloudflare Workers",
   "main": "dist/index.js",
   "bin": {