@isnow890/naver-search-mcp 1.0.18 → 1.0.19

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 isnow890
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE. 
+MIT License
+
+Copyright (c) 2025 isnow890
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -1,187 +1,205 @@
-# Naver Search MCP Server
-
-[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
-[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
-[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
-
-MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
-
-#### Version History
-
-###### 1.0.2 (2025-04-26)
-
-- README updated: cafe article search tool and version history section improved
-
-###### 1.0.1 (2025-04-26)
-
-- Cafe article search feature added
-- Shopping category info added to zod
-- Source code refactored
-
-###### 1.0.0 (2025-04-08)
-
-- Initial release
-
-#### Information
-
-**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
-
-#### Prerequisites
-
-- Naver Developers API Key (Client ID and Secret)
-- Node.js 18 or higher
-- NPM 8 or higher
-- Docker (optional, for container deployment)
-
-#### Getting API Keys
-
-1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
-2. Click "Register Application"
-3. Enter application name and select ALL of the following APIs:
-   - Search (for blog, news, book search, etc.)
-   - DataLab (Search Trends)
-   - DataLab (Shopping Insight)
-4. Set the obtained Client ID and Client Secret as environment variables
-
-## Tool Details
-
-### Available tools:
-
-- **search_webkr**: Search Naver web documents
-- **search_news**: Search Naver news
-- **search_blog**: Search Naver blogs
-- **search_cafearticle**: Search Naver cafe articles
-- **search_shop**: Search Naver shopping
-- **search_image**: Search Naver images
-- **search_kin**: Search Naver KnowledgeiN
-- **search_book**: Search Naver books
-- **search_encyc**: Search Naver encyclopedia
-- **search_academic**: Search Naver academic papers
-- **search_local**: Search Naver local places
-- **datalab_search**: Analyze search term trends
-- **datalab_shopping_category**: Analyze shopping category trends
-- **datalab_shopping_by_device**: Analyze shopping trends by device
-- **datalab_shopping_by_gender**: Analyze shopping trends by gender
-- **datalab_shopping_by_age**: Analyze shopping trends by age group
-- **datalab_shopping_keywords**: Analyze shopping keyword trends
-- **datalab_shopping_keyword_by_device**: Analyze shopping keyword trends by device
-- **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender
-- **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group
-
-## Installation
-
-### Option 1: Quick Install via Smithery (Recommended)
-
-To install Naver Search MCP Server automatically via Smithery, use one of these commands based on your AI client:
-
-For Claude Desktop:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
-```
-
-For Cursor:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
-```
-
-For Windsurf:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
-```
-
-For Cline:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
-```
-
-The installer will prompt you for:
-
-- NAVER_CLIENT_ID
-- NAVER_CLIENT_SECRET
-
-### Option 2: Manual Installation
-
-#### Environment Variables
-
-```bash
-# Windows
-set NAVER_CLIENT_ID=your_client_id
-set NAVER_CLIENT_SECRET=your_client_secret
-
-# Linux/Mac
-export NAVER_CLIENT_ID=your_client_id
-export NAVER_CLIENT_SECRET=your_client_secret
-```
-
-#### Run with NPX
-
-```bash
-npx @modelcontextprotocol/server-naver-search
-```
-
-#### Run with Docker
-
-```bash
-docker run -i --rm \
-  -e NAVER_CLIENT_ID=your_client_id \
-  -e NAVER_CLIENT_SECRET=your_client_secret \
-  mcp/naver-search
-```
-
-## Cursor Desktop Configuration
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-naver-search"],
-      "env": {
-        "NAVER_CLIENT_ID": "your_client_id",
-        "NAVER_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-For Docker:
-
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "-e",
-        "NAVER_CLIENT_ID=your_client_id",
-        "-e",
-        "NAVER_CLIENT_SECRET=your_client_secret",
-        "mcp/naver-search"
-      ]
-    }
-  }
-}
-```
-## Build
-
-Docker build:
-
-```bash
-docker build -t mcp/naver-search .
-```
-
-
-
-## License
-
-MIT License
+# Naver Search MCP Server
+
+[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
+[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
+[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
+
+MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
+
+#### Version History
+
+###### 1.0.2 (2025-04-26)
+
+- README updated: cafe article search tool and version history section improved
+
+###### 1.0.1 (2025-04-26)
+
+- Cafe article search feature added
+- Shopping category info added to zod
+- Source code refactored
+
+###### 1.0.0 (2025-04-08)
+
+- Initial release
+
+#### Information
+
+**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
+
+#### Prerequisites
+
+- Naver Developers API Key (Client ID and Secret)
+- Node.js 18 or higher
+- NPM 8 or higher
+- Docker (optional, for container deployment)
+
+#### Getting API Keys
+
+1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
+2. Click "Register Application"
+3. Enter application name and select ALL of the following APIs:
+   - Search (for blog, news, book search, etc.)
+   - DataLab (Search Trends)
+   - DataLab (Shopping Insight)
+4. Set the obtained Client ID and Client Secret as environment variables
+
+## Tool Details
+
+### Available tools:
+
+- **search_webkr**: Search Naver web documents
+- **search_news**: Search Naver news
+- **search_blog**: Search Naver blogs
+- **search_cafearticle**: Search Naver cafe articles
+- **search_shop**: Search Naver shopping
+- **search_image**: Search Naver images
+- **search_kin**: Search Naver KnowledgeiN
+- **search_book**: Search Naver books
+- **search_encyc**: Search Naver encyclopedia
+- **search_academic**: Search Naver academic papers
+- **search_local**: Search Naver local places
+- **datalab_search**: Analyze search term trends
+- **datalab_shopping_category**: Analyze shopping category trends
+- **datalab_shopping_by_device**: Analyze shopping trends by device
+- **datalab_shopping_by_gender**: Analyze shopping trends by gender
+- **datalab_shopping_by_age**: Analyze shopping trends by age group
+- **datalab_shopping_keywords**: Analyze shopping keyword trends
+- **datalab_shopping_keyword_by_device**: Analyze shopping keyword trends by device
+- **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender
+- **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group
+
+## Installation
+
+### Option 1: Quick Install via Smithery (Recommended)
+
+To install Naver Search MCP Server automatically via Smithery, use one of these commands based on your AI client:
+
+For Claude Desktop:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
+```
+
+For Cursor:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
+```
+
+For Windsurf:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
+```
+
+For Cline:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
+```
+
+The installer will prompt you for:
+
+- NAVER_CLIENT_ID
+- NAVER_CLIENT_SECRET
+
+### Option 2: Manual Installation
+
+#### Environment Variables
+
+```bash
+# Windows
+set NAVER_CLIENT_ID=your_client_id
+set NAVER_CLIENT_SECRET=your_client_secret
+
+# Linux/Mac
+export NAVER_CLIENT_ID=your_client_id
+export NAVER_CLIENT_SECRET=your_client_secret
+```
+
+#### Run with NPX
+
+```bash
+npx @isnow890/naver-search-mcp
+```
+
+#### Run with Docker
+
+```bash
+docker run -i --rm \
+  -e NAVER_CLIENT_ID=your_client_id \
+  -e NAVER_CLIENT_SECRET=your_client_secret \
+  mcp/naver-search
+```
+
+## Claude Desktop Configuration
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "naver-search": {
+      "command": "npx",
+      "args": ["-y", "@isnow890/naver-search-mcp"],
+      "env": {
+        "NAVER_CLIENT_ID": "your_client_id",
+        "NAVER_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+## Cursor AI Configuration
+
+Add to `mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "naver-search": {
+      "command": "npx",
+      "args": ["-y", "@isnow890/naver-search-mcp"],
+      "env": {
+        "NAVER_CLIENT_ID": "your_client_id",
+        "NAVER_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+For Docker:
+
+```json
+{
+  "mcpServers": {
+    "naver-search": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "NAVER_CLIENT_ID=your_client_id",
+        "-e",
+        "NAVER_CLIENT_SECRET=your_client_secret",
+        "mcp/naver-search"
+      ]
+    }
+  }
+}
+```
+
+## Build
+
+Docker build:
+
+```bash
+docker build -t mcp/naver-search .
+```
+
+## License
+
+MIT License

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@isnow890/naver-search-mcp",
-    "version": "1.0.18",
+    "version": "1.0.19",
     "description": "Naver Search MCP Server",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -12,7 +12,8 @@
         "build": "tsc",
         "prepare": "npm run build",
         "watch": "tsc --watch",
-        "start": "node dist/src/index.js"
+        "start": "node dist/src/index.js",
+        "test": "npx cross-env NODE_OPTIONS=--experimental-vm-modules npx jest"
     },
     "engines": {
         "node": ">=18"
@@ -20,14 +21,17 @@
     "dependencies": {
         "@modelcontextprotocol/sdk": "1.10.2",
         "axios": "^1.6.7",
-        "zod": "^3.22.4",
-        "zod-to-json-schema": "^3.23.5",
+        "dotenv": "^16.4.5",
         "sharp": "^0.33.2",
-        "dotenv": "^16.4.5"
+        "zod": "^3.22.4",
+        "zod-to-json-schema": "^3.23.5"
     },
     "devDependencies": {
+        "@types/jest": "^29.5.14",
         "@types/node": "^22",
+        "jest": "^29.7.0",
         "shx": "^0.3.4",
+        "ts-jest": "^29.3.2",
         "typescript": "^5.3.3"
     },
     "author": "isnow890",

package/dist/src/handlers/unified-search.handlers.js

@@ -0,0 +1,144 @@
+import { searchToolHandlers } from "./search.handlers.js";
+import { datalabToolHandlers } from "./datalab.handlers.js";
+import { UnifiedSearchSchema } from "../schemas/unified-search.schemas.js";
+/**
+ * 통합 검색 핸들러
+ * 일반 검색과 트렌드 검색을 통합하여 처리
+ * @param args 통합 검색 파라미터
+ * @returns 검색 결과
+ */
+export async function handleUnifiedSearch(args) {
+    // Zod를 사용하여 입력 파라미터 검증
+    const parsedArgs = UnifiedSearchSchema.parse(args);
+    // 검색 유형에 따라 처리
+    if (parsedArgs.searchType === "general") {
+        return handleGeneralSearch(parsedArgs);
+    }
+    else if (parsedArgs.searchType === "trend") {
+        return handleTrendSearch(parsedArgs);
+    }
+    throw new Error("지원하지 않는 검색 유형입니다.");
+}
+/**
+ * 일반 검색 핸들러
+ * @param search 일반 검색 파라미터
+ * @returns 검색 결과
+ */
+async function handleGeneralSearch(search) {
+    const { generalType, params } = search;
+    // 모든 검색 타입을 통합하여 검색하는 경우
+    if (generalType === "all") {
+        return handleAllGeneralSearch(params);
+    }
+    // 단일 검색 유형인 경우
+    const handlerKey = `search_${generalType}`;
+    const handler = searchToolHandlers[handlerKey];
+    if (!handler) {
+        throw new Error(`'${generalType}' 유형에 대한 검색 핸들러가 없습니다.`);
+    }
+    return handler(params);
+}
+/**
+ * 모든 일반 검색을 병렬로 수행하는 핸들러
+ * @param params 검색 파라미터
+ * @returns 모든 검색 결과 (검색 유형별로 객체 키 할당)
+ */
+async function handleAllGeneralSearch(params) {
+    // 모든 가능한 일반 검색 타입 (local과 다른 타입은 파라미터가 다르므로 주의)
+    // 검색할 타입 목록 (local은 파라미터가 다르므로 처리 방식 구분)
+    const generalTypes = [
+        "webkr", "news", "blog", "shop", "image",
+        "kin", "book", "encyc", "academic", "cafearticle"
+    ];
+    // Promise 배열 생성 및 결과 수집
+    const searchPromises = generalTypes.map(type => {
+        const handlerKey = `search_${type}`;
+        const handler = searchToolHandlers[handlerKey];
+        return handler(params)
+            .then(result => ({ type, result }))
+            .catch(error => ({ type, error: error.message }));
+    });
+    // local 검색은 파라미터가 다르지만 동일 인터페이스로 처리
+    const localHandler = searchToolHandlers["search_local"];
+    searchPromises.push(localHandler(params)
+        .then(result => ({ type: "local", result }))
+        .catch(error => ({ type: "local", error: error.message })));
+    // 모든 검색 병렬 실행
+    const results = await Promise.all(searchPromises);
+    // 결과를 유형별로 객체로 변환
+    return results.reduce((acc, item) => {
+        const { type } = item;
+        if ('result' in item) {
+            acc[type] = item.result;
+        }
+        else if ('error' in item) {
+            acc[type] = { error: item.error };
+        }
+        return acc;
+    }, {});
+}
+/**
+ * 트렌드 검색 핸들러
+ * @param search 트렌드 검색 파라미터
+ * @returns 검색 결과
+ */
+async function handleTrendSearch(search) {
+    const { trendType, params } = search;
+    // 모든 트렌드 타입을 통합하여 검색하는 경우
+    if (trendType === "all") {
+        return handleAllTrendSearch(params);
+    }
+    // 단일 트렌드 검색 유형인 경우
+    const handlerKey = `datalab_${trendType}`;
+    const handler = datalabToolHandlers[handlerKey];
+    if (!handler) {
+        throw new Error(`'${trendType}' 유형에 대한 트렌드 검색 핸들러가 없습니다.`);
+    }
+    return handler(params);
+}
+/**
+ * 모든 트렌드 검색을 병렬로 수행하는 핸들러
+ * @param params 트렌드 검색 파라미터
+ * @returns 모든 트렌드 검색 결과 (검색 유형별로 객체 키 할당)
+ */
+async function handleAllTrendSearch(params) {
+    // 파라미터 유형에 따라 가능한 트렌드 검색 타입 결정
+    const trendTypes = [
+        "search"
+    ];
+    // 쇼핑 관련 트렌드는 category 파라미터가 있어야 함
+    if (params.category) {
+        trendTypes.push("shopping_category", "shopping_by_device", "shopping_by_gender", "shopping_by_age", "shopping_keywords");
+        // 키워드 관련 트렌드는 keyword 파라미터가 있어야 함
+        if (params.keyword) {
+            trendTypes.push("shopping_keyword_by_device", "shopping_keyword_by_gender", "shopping_keyword_by_age");
+        }
+    }
+    // Promise 배열 생성 및 결과 수집
+    const trendPromises = trendTypes.map(type => {
+        const handlerKey = `datalab_${type}`;
+        const handler = datalabToolHandlers[handlerKey];
+        // 일부 트렌드 검색은 파라미터 형식이 다를 수 있으므로 
+        // 에러가 발생해도 다른 검색은 계속 진행하도록 처리
+        return handler(params)
+            .then((result) => ({ type, result }))
+            .catch((error) => ({ type, error: error.message }));
+    });
+    // 모든 트렌드 검색 병렬 실행
+    const results = await Promise.all(trendPromises);
+    // 결과를 유형별로 객체로 변환
+    return results.reduce((acc, item) => {
+        const { type } = item;
+        if ('result' in item) {
+            acc[type] = item.result;
+        }
+        else if ('error' in item) {
+            acc[type] = { error: item.error };
+        }
+        return acc;
+    }, {});
+}
+// 통합 검색 도구 핸들러 맵
+export const unifiedSearchToolHandlers = {
+    unified_search: (args) => handleUnifiedSearch(args)
+};

package/dist/src/index.js

@@ -6,10 +6,8 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { NaverSearchClient } from "./clients/naver-search.client.js";
-import { searchTools } from "./tools/search.tools.js";
-import { datalabTools } from "./tools/datalab.tools.js";
-import { searchToolHandlers } from "./handlers/search.handlers.js";
-import { datalabToolHandlers } from "./handlers/datalab.handlers.js";
+import { unifiedSearchTools } from "./tools/unified-search.tools.js";
+import { unifiedSearchToolHandlers } from "./handlers/unified-search.handlers.js";
 dotenv.config();
 console.error("[MCP] dotenv.config() 실행됨");
 // 환경 변수 유효성 검사
@@ -41,12 +39,17 @@ console.error("[MCP] Server 인스턴스 생성 완료");
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     console.error("[MCP] ListToolsRequestSchema 핸들러 호출됨");
     return {
-        tools: [...searchTools, ...datalabTools],
+        tools: [
+            //...searchTools,
+            // //  ...datalabTools, 
+            ...unifiedSearchTools
+        ],
     };
 });
 const toolHandlers = {
-    ...searchToolHandlers,
-    ...datalabToolHandlers,
+    // ...searchToolHandlers,
+    // ...datalabToolHandlers,
+    ...unifiedSearchToolHandlers,
 };
 // 에러 응답 헬퍼 함수
 function createErrorResponse(error) {