daiso 1.0.2 → 1.0.3

package/README.md

@@ -41,6 +41,7 @@ CLI (npx):
 
 ```bash
 npx daiso help
+npx daiso help products
 npx daiso url
 npx daiso health
 npx daiso claude

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,34 +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('  get                  임의 API 경로 GET 호출');
-    writeOut('  products             다이소 제품 검색');
-    writeOut('  product              다이소 제품 상세 조회');
-    writeOut('  stores               다이소 매장 검색');
-    writeOut('  inventory            다이소 재고 조회');
-    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');
-}
 async function execCommand(command, args) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -144,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;
     }
@@ -193,6 +170,9 @@ export async function runCli(argv, deps) {
     }
     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 수납박스');
@@ -204,6 +184,9 @@ export async function runCli(argv, deps) {
     }
     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 수납박스');
@@ -216,6 +199,9 @@ export async function runCli(argv, deps) {
     }
     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');
@@ -227,6 +213,9 @@ export async function runCli(argv, deps) {
     }
     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;
@@ -241,6 +230,9 @@ export async function runCli(argv, deps) {
     }
     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 강남역');

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.2",
+  "version": "1.0.3",
   "description": "Daiso MCP Server for mobile access via Cloudflare Workers",
   "main": "dist/index.js",
   "bin": {