npm - @isnow890/naver-search-mcp - Versions diffs - 1.0.51 → 1.0.53 - Mend

@isnow890/naver-search-mcp 1.0.51 → 1.0.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +57 -341
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,165 +1,27 @@
-# Naver Search MCP Server
-[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
-[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/isnow890/naver-search-mcp)](https://archestra.ai/mcp-catalog/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.
-> [!WARNING]
-> ### ⚠️ [Archived] Project Discontinuation & Service End Notice
->
-> Due to changes in Naver's API policies and terms of service, **active development and maintenance of this repository have been officially discontinued, and this repository is now archived (read-only)**.
->
-> - **End of Maintenance**: No new features, bug fixes, issues, or pull requests will be supported.
-> - **Kakao PlayMCP Discontinuation**: The zero-setup Kakao PlayMCP service integration has also been shut down.
-> - **Code Preservation**: Existing code remains publicly available for reference and study under the MIT License.
->
-> Thank you very much to everyone who supported, starred, and used `naver-search-mcp` throughout this project! 🙏
-## ⚠️ Naver is migrating these APIs — read this before you set up
-Naver is moving Search, Search Trend, and Shopping Insight from the Naver Developers Center to **NAVER API HUB** on NAVER Cloud Platform, and is shutting down three search APIs entirely.
-| Date | What happens |
-|---|---|
-| **2026-07-31** | Developers Center stops accepting **new** key applications.<br>Shopping / Book / Academic search APIs shut down completely. |
-| **2027-06-30** | Developers Center support ends — **existing keys stop working**. |
-Source: [Naver Developers Center official notice](https://developers.naver.com/notice/article/32530) (Korean) — "Search API, Search Trend, Shopping Insight 서비스 종료 및 NAVER API HUB 이관 안내".
-**Setting this up for the first time?** Get your keys from NAVER API HUB. The Developers Center path closes to new applicants on 2026-07-31, so it is no longer the place to start. Step-by-step instructions are in [Option A: NAVER API HUB](#option-a-naver-api-hub-recommended--the-forward-path) below.
-**Already running with Developers Center keys?** Nothing to change. They keep working until 2027-06-30, and this version supports both platforms from the same install. When you're ready, get a HUB key and swap the two environment variables — no other changes.
-**Support plan for this server:** both platforms stay supported side by side through Naver's 2027-06-30 cutoff. The Developers Center path will be dropped in a later major version only after that date, once it can no longer work for anyone — so upgrading in the meantime will never take your working setup away.
-**Three tools were removed in 1.0.49**: `search_shop`, `search_book`, `search_academic`. Naver shuts those search APIs down on 2026-07-31 with no replacement on any platform, so there is nothing this server can do to keep them. Shopping **Insight** (`datalab_shopping_*`) and `find_category` are a *different* API and are **not** affected.
-## Available on ClawHub for OpenClaw
-You can install this MCP server as an OpenClaw skill from ClawHub:
-```bash
-openclaw skills install naver-search-mcp
-```
-The ClawHub skill uses the published npm package internally and needs **one** credential pair in your OpenClaw environment — either the NAVER API HUB pair (`NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`) or the Developers Center pair (`NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`). OpenClaw's `apiKey` field maps to `NAVER_CLIENT_SECRET`; HUB users should set both HUB variables explicitly in the environment instead of using `apiKey`.
-## ~~Quick Start: Use Without API Key (Discontinued)~~
-> **Notice:** Following the archiving and discontinuation of this project, the zero-setup service on [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154) has also been shut down. Thank you to everyone who tried it out!
-## Tool Details
-### Available tools:
-#### 🆕 Category Search
-- **find_category**: Category search tool so you no longer need to manually check category numbers in URLs for trend and shopping insight searches. Just describe the category in natural language.
-#### Search Tools
-- **search_webkr**: Search Naver web documents
-- **search_news**: Search Naver news
-- **search_blog**: Search Naver blogs
-- **search_cafearticle**: Search Naver cafe articles
-- **search_image**: Search Naver images
-- **search_kin**: Search Naver KnowledgeiN
-- **search_encyc**: Search Naver encyclopedia
-- **search_local**: Search Naver local places
-> **Removed in 1.0.49:** `search_shop`, `search_book`, `search_academic`.
-> Naver shuts down the Shopping / Book / Academic search APIs on 2026-07-31 with
-> no replacement on any platform. This is not a limitation of this server.
-> Shopping **Insight** (`datalab_shopping_*`) is a different API and is unaffected.
-#### DataLab Tools
-- **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
-## Getting API Keys
-Two platforms issue keys for this server. Set **one** pair of environment variables — see
-[Configuration](#configuration) below for how the pair you set determines the platform used.
+<p align="center">
+  <img src="https://img1.kakaocdn.net/thumb/R0x200a.i/?fname=https%3A%2F%2Ft1.kakaocdn.net%2Fkomi%2Fupload-files%2Fmcp%2Fimages%2FnQzoe8vIxql0oK7Rwi239dxO2iYrxozLLQCIPRpVjmOjwGyPw0ZNUnNJfGkO1kAZmKf16eLZPAYi8NIS8XaBZJ.png" alt="Naver Search MCP Server Logo" width="128" />
+</p>
-### Option A: NAVER API HUB (recommended — the forward path)
-1. Go to the [NAVER Cloud Platform console](https://www.ncloud.com) and sign up or log in.
-2. Click the region & platform selector in the top right of the console, choose your region/platform, and click **Apply**.
-3. Open **Menu > All Services > Application Services > [NAVER API HUB](https://www.ncloud.com/product/applicationService/naverApiHub)**.
-4. Click **Application**, select (or create) your application, then under API management click **인증 정보 (Authentication Info)**.
-5. Copy the **Client ID** and **Client Secret** shown in the popup.
-6. Use these as `NCP_APIGW_API_KEY_ID` (Client ID) and `NCP_APIGW_API_KEY` (Client Secret) in the configuration below.
-### Option B: Naver Developers (legacy — existing keys only)
-> Naver Developers Center stops accepting new applications on **2026-07-31**. If you don't
-> already have a Client ID/Secret from this platform, use NAVER API HUB above instead.
-> Existing Developers Center keys keep working until 2027-06-30.
-1. Visit [Naver Developers](https://developers.naver.com/apps/#/register) and log in with your Naver account
-2. Click the "Application Registration" (애플리케이션 등록) button
-3. Fill in the application information:
-   - **Application Name**: Enter any name (e.g., "Naver Search MCP")
-   - **Usage**: Select "Search" (검색)
-4. In the API Settings section, check ALL of the following APIs:
-   - **Search** (검색) - Required for blog, news, cafe article, web, image, kin, encyclopedia, and local search
-   - **DataLab - Search Trends** (데이터랩 - 검색어 트렌드) - Required for search term trend analysis
-   - **DataLab - Shopping Insight** (데이터랩 - 쇼핑인사이트) - Required for shopping trend analysis
-5. Click "Register" to complete registration
-6. After registration, you'll see your **Client ID** and **Client Secret** on the application detail page
-7. Use these as `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET` in the configuration below
-## Configuration
-### Credentials
-Two platforms are supported. Set **one** pair — the server picks the platform from
-which variables you set, since the key strings themselves are indistinguishable.
-| Variables | Platform | Endpoint |
-|---|---|---|
-| `NCP_APIGW_API_KEY_ID`, `NCP_APIGW_API_KEY` | NAVER API HUB (NCP) | `naverapihub.apigw.ntruss.com` |
-| `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` | Naver Developers (legacy) | `openapi.naver.com` |
-If both pairs are set, NAVER API HUB wins.
-The installation examples below use the legacy `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`
-pair; swap in the HUB pair from the table above if that's what you have.
-### Migration to NAVER API HUB
+# Naver Search MCP Server
-Naver is moving these APIs from the Developers Center to NAVER API HUB on NAVER Cloud Platform.
+[![npm version](https://img.shields.io/npm/v/@isnow890/naver-search-mcp.svg)](https://www.npmjs.com/package/@isnow890/naver-search-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-| Date | What happens |
-|---|---|
-| 2026-06-25 | NAVER API HUB launched |
-| 2026-07-31 | Developers Center stops accepting new applications |
-| 2027-06-30 | Developers Center support ends — existing keys stop working |
+네이버 검색 API 및 DataLab(데이터랩) API 연동을 위한 Model Context Protocol(MCP) 서버입니다.
+웹, 뉴스, 블로그, 쇼핑인사이트, 검색어 트렌드 분석 및 자연어 쇼핑 카테고리 검색을 지원합니다.
-Existing keys keep working until 2027-06-30. To migrate, get a key from the
-NAVER Cloud Platform console and set `NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`.
-Developers Center keys cannot be used against NAVER API HUB.
+* [English Documentation (README-en.md)](README-en.md)
-## Installation
+---
-### Method 1: NPX Installation (Recommended)
+## 빠른 설정 (Quick Start)
-The most reliable way to use this MCP server is through NPX. For detailed package information, see the [NPM package page](https://www.npmjs.com/package/@isnow890/naver-search-mcp).
+Claude Desktop, Cursor, Claude Code, Cline 등 사용하시는 MCP 클라이언트 설정 파일(`claude_desktop_config.json`, `mcp.json` 등)의 `mcpServers`에 아래 설정을 추가하세요.
-#### Claude Desktop Configuration
+> **안내:** [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154) 연동 서비스는 지원이 종료되었습니다. 로컬 환경에서 직접 API 키를 설정하여 이용해 주세요.
-Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS/Linux):
+### 1. NAVER API HUB (권장 / 신규 발급)
+네이버 클라우드 플랫폼(NCP)의 [NAVER API HUB](https://www.ncloud.com/product/applicationService/naverApiHub) 키를 사용하는 경우:
 ```json
 {
@@ -168,17 +30,16 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
       "command": "npx",
       "args": ["-y", "@isnow890/naver-search-mcp"],
       "env": {
-        "NAVER_CLIENT_ID": "your_client_id",
-        "NAVER_CLIENT_SECRET": "your_client_secret"
+        "NCP_APIGW_API_KEY_ID": "your_client_id",
+        "NCP_APIGW_API_KEY": "your_client_secret"
       }
     }
   }
 }
 ```
-#### Claude Code Configuration
-Add to your Claude Code settings:
+### 2. 네이버 개발자센터 (기존 발급자 전용)
+기존 네이버 개발자센터(`openapi.naver.com`) 키를 사용하는 경우 (2027-06-30까지 지원):
 ```json
 {
@@ -195,201 +56,56 @@ Add to your Claude Code settings:
 }
 ```
-### Method 2: ClawHub Installation for OpenClaw
-This MCP server can also be used from OpenClaw through the ClawHub skill wrapper. Install it with:
+### 3. OpenClaw (ClawHub)
+OpenClaw를 사용하는 경우 ClawHub 스킬로 즉시 설치할 수 있습니다:
 ```bash
 openclaw skills install naver-search-mcp
 ```
-The ClawHub skill uses the same published npm package internally:
-```bash
-npx -y @isnow890/naver-search-mcp
-```
-Make sure **one** credential pair is configured in your OpenClaw environment before using the skill — the NAVER API HUB pair (`NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`) or the Developers Center pair (`NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`). OpenClaw's `apiKey` field maps to `NAVER_CLIENT_SECRET`; HUB users should set both HUB variables explicitly instead.
-### Method 3: Local Installation
-For local development or custom modifications:
-#### Step 1: Download and Build Source Code
-##### Clone with Git
-```bash
-git clone https://github.com/isnow890/naver-search-mcp.git
-cd naver-search-mcp
-npm install
-npm run build
-```
-##### Or Download ZIP File
-1. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp)
-2. Extract the ZIP file to your desired location
-3. Navigate to the extracted folder in terminal:
-```bash
-cd /path/to/naver-search-mcp
-npm install
-npm run build
-```
-⚠️ **Important**: You must run `npm run build` after installation to generate the `dist` folder that contains the compiled JavaScript files.
-#### Step 2: Claude Desktop Configuration
-After building, you'll need the following information:
-- **NAVER_CLIENT_ID**: Client ID from Naver Developers
-- **NAVER_CLIENT_SECRET**: Client Secret from Naver Developers
-- **Installation Path**: Absolute path to the downloaded folder
-##### Windows Configuration
-Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "type": "stdio",
-      "command": "cmd",
-      "args": [
-        "/c",
-        "node",
-        "C:\\path\\to\\naver-search-mcp\\dist\\src\\index.js"
-      ],
-      "cwd": "C:\\path\\to\\naver-search-mcp",
-      "env": {
-        "NAVER_CLIENT_ID": "your-naver-client-id",
-        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
-      }
-    }
-  }
-}
-```
-##### macOS/Linux Configuration
-Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["/path/to/naver-search-mcp/dist/src/index.js"],
-      "cwd": "/path/to/naver-search-mcp",
-      "env": {
-        "NAVER_CLIENT_ID": "your-naver-client-id",
-        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
-      }
-    }
-  }
-}
-```
-##### Path Configuration Important Notes
+> **참고:** OpenClaw 환경에 NAVER API HUB 쌍(`NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`) 또는 개발자센터 쌍(`NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`) 중 **한 쌍**을 설정해야 합니다.
-⚠️ **Important**: You must change the following paths in the above configuration to your actual installation paths:
-- **Windows**: Change `C:\\path\\to\\naver-search-mcp` to your actual downloaded folder path
-- **macOS/Linux**: Change `/path/to/naver-search-mcp` to your actual downloaded folder path
-- **Build Path**: Make sure the path points to `dist/src/index.js` (not just `index.js`)
-Finding your path:
+---
-```bash
-# Check current location
-pwd
+## API 키 발급 안내
-# Absolute path examples
-# Windows: C:\Users\username\Downloads\naver-search-mcp
-# macOS: /Users/username/Downloads/naver-search-mcp
-# Linux: /home/username/Downloads/naver-search-mcp
-```
+사용하시는 환경변수 쌍에 따라 호출 플랫폼이 자동으로 결정됩니다. (둘 중 **한 쌍만** 설정하세요)
-#### Step 3: Restart Claude Desktop
+| 플랫폼 | 환경변수 | 비고 |
+|---|---|---|
+| **NAVER API HUB (권장)** | `NCP_APIGW_API_KEY_ID`<br>`NCP_APIGW_API_KEY` | • [네이버 클라우드 플랫폼 콘솔](https://www.ncloud.com) 접속<br>• Menu > All Services > Application Services > **NAVER API HUB** > Application 등록 후 '인증 정보' 확인 |
+| **네이버 개발자센터 (기존)** | `NAVER_CLIENT_ID`<br>`NAVER_CLIENT_SECRET` | • 2026-07-31 부로 신규 발급 차단됨<br>• 기존 발급된 키는 2027-06-30까지 정상 동작 |
-After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.
+---
-## Prerequisites
+## 제공 도구 (Tools)
+### 1. 카테고리 검색
+- **`find_category`**: 카테고리 번호를 몰라도 자연어로 검색하여 쇼핑 인사이트용 카테고리 ID를 조회합니다.
+### 2. 검색 도구 (Search)
+- **`search_webkr`**: 웹 문서 검색
+- **`search_news`**: 뉴스 검색
+- **`search_blog`**: 블로그 검색
+- **`search_cafearticle`**: 카페 글 검색
+- **`search_image`**: 이미지 검색
+- **`search_kin`**: 지식iN 검색
+- **`search_encyc`**: 백과사전 검색
+- **`search_local`**: 지역 장소 검색
+### 3. 데이터랩 트렌드 분석 (DataLab)
+날짜 파라미터에 `"today"` 키워드를 지원합니다 (예: `endDate: "today"`).
+- **`datalab_search`**: 검색어 트렌드 분석
+- **`datalab_shopping_category`**: 쇼핑 카테고리별 클릭 트렌드
+- **`datalab_shopping_by_device`**: 기기별(PC/모바일) 쇼핑 트렌드
+- **`datalab_shopping_by_gender`**: 성별 쇼핑 트렌드
+- **`datalab_shopping_by_age`**: 연령대별 쇼핑 트렌드
+- **`datalab_shopping_keywords`**: 쇼핑 키워드 트렌드
+- **`datalab_shopping_keyword_by_device`**: 키워드 기기별 트렌드
+- **`datalab_shopping_keyword_by_gender`**: 키워드 성별 트렌드
+- **`datalab_shopping_keyword_by_age`**: 키워드 연령별 트렌드
-- A credential pair for one platform — NAVER API HUB or Naver Developers (see [Getting API Keys](#getting-api-keys))
-- Node.js 18 or higher
-- NPM 8 or higher
+---
 ## License
 MIT License
----
-## Version History
-### 1.0.49 (2026-07-26)
-- NAVER API HUB support: set `NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY` to call the new platform. Existing `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET` keep working unchanged — the platform is chosen by which variable pair you set
-- **Removed** `search_shop`, `search_book`, `search_academic`. Naver shuts those search APIs down on 2026-07-31 with no replacement on any platform
-- API errors now throw a plain `Error` instead of the raw `AxiosError`. Code branching on `error.response?.status` sees `undefined`; the same detail is in `Error.message`
-- Error messages name the platform and HTTP status, and 401s suggest checking whether a key was set on the other platform's variables
-### 1.0.48 (2026-05-12)
-- Fixed `find_category` data loading when the MCP server is launched by `npx` from a different working directory
-- Category data is now resolved relative to the installed package before falling back to local development paths
-### 1.0.47 (2025-01-03)
-- **Added "today" keyword support** for all DataLab date parameters - no need to call separate time tool
-- **Fixed server termination issue** - MCP server now properly exits when client disconnects
-- **Added graceful shutdown handlers** for SIGINT, SIGTERM, and transport close events
-- **Removed get_current_korean_time tool** - redundant with new "today" keyword feature
-- **Removed memory monitoring module** - resolved setInterval blocking process exit
-- **Special thanks to @gloomyrobot** for reporting the server termination issue
-### 1.0.45 (2025-09-28)
-- Resolved platform compatibility issues for hosted MCP installations
-- Replaced the Excel export in category search with JSON for better compatibility
-- Restored the `search_webkr` tool for Korean web search
-- Improved hosted platform installation compatibility
-### 1.0.44 (2025-08-31)
-- Added the `get_current_korean_time` tool for essential Korea Standard Time context
-- Referenced the time tool across existing tool descriptions for temporal queries
-- Improved handling of "today", "now", and "current" searches with temporal context
-- Expanded Korean date and time formatting outputs with multiple formats
-### 1.0.40 (2025-08-21)
-- Added the `find_category` tool with fuzzy matching so you no longer need to check category numbers manually in URLs
-- Enhanced parameter validation with Zod schema
-- Improved the category search workflow
-- Implemented a level-based category ranking system that prioritizes top-level categories
-### 1.0.30 (2025-08-04)
-- MCP SDK upgraded to 1.17.1
-- Fixed compatibility issues with hosted MCP platform specification changes
-- Added comprehensive DataLab shopping category code documentation
-### 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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@isnow890/naver-search-mcp",
-  "version": "1.0.51",
+  "version": "1.0.53",
   "description": "Naver Search MCP Server",
   "main": "dist/src/index.js",
   "module": "./src/index.ts",