MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis. You can use this server immediately without API keys through Kakao PlayMCP. Simply visit the link and start using it right away! - findcategory: Category search tool so you no longer need to manually check category numbers in URLs for trend and shopping
Add this skill
npx mdskills install isnow890/naver-search-mcpComprehensive MCP server with 20+ tools for Naver search and data analysis, excellent documentation and multiple installation options
1# Naver Search MCP Server23[](README-ko.md)45[](https://archestra.ai/mcp-catalog/isnow890__naver-search-mcp)6[](https://smithery.ai/server/@isnow890/naver-search-mcp)7[](https://mcp.so/server/naver-search-mcp/isnow890)89MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.1011## Quick Start: Use Without API Key1213You can use this server immediately without API keys through [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154). Simply visit the link and start using it right away!1415## Tool Details1617### Available tools:1819#### 🆕 Category Search2021- **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.2223#### Search Tools2425- **search_webkr**: Search Naver web documents26- **search_news**: Search Naver news27- **search_blog**: Search Naver blogs28- **search_cafearticle**: Search Naver cafe articles29- **search_shop**: Search Naver shopping30- **search_image**: Search Naver images31- **search_kin**: Search Naver KnowledgeiN32- **search_book**: Search Naver books33- **search_encyc**: Search Naver encyclopedia34- **search_academic**: Search Naver academic papers35- **search_local**: Search Naver local places3637#### DataLab Tools3839- **datalab_search**: Analyze search term trends40- **datalab_shopping_category**: Analyze shopping category trends41- **datalab_shopping_by_device**: Analyze shopping trends by device42- **datalab_shopping_by_gender**: Analyze shopping trends by gender43- **datalab_shopping_by_age**: Analyze shopping trends by age group44- **datalab_shopping_keywords**: Analyze shopping keyword trends45- **datalab_shopping_keyword_by_device**: Analyze shopping keyword trends by device46- **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender47- **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group4849## Getting API Keys50511. Visit [Naver Developers](https://developers.naver.com/apps/#/register) and log in with your Naver account522. Click the "Application Registration" (애플리케이션 등록) button533. Fill in the application information:54 - **Application Name**: Enter any name (e.g., "Naver Search MCP")55 - **Usage**: Select "Search" (검색)564. In the API Settings section, check ALL of the following APIs:57 - **Search** (검색) - Required for blog, news, book, cafe article, web, image, kin, encyclopedia, academic, and local search58 - **DataLab - Search Trends** (데이터랩 - 검색어 트렌드) - Required for search term trend analysis59 - **DataLab - Shopping Insight** (데이터랩 - 쇼핑인사이트) - Required for shopping trend analysis605. Click "Register" to complete registration616. After registration, you'll see your **Client ID** and **Client Secret** on the application detail page627. Use these credentials in the configuration below6364## Installation6566### Method 1: NPX Installation (Recommended)6768The 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).6970#### Claude Desktop Configuration7172Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS/Linux):7374```json75{76 "mcpServers": {77 "naver-search": {78 "command": "npx",79 "args": ["-y", "@isnow890/naver-search-mcp"],80 "env": {81 "NAVER_CLIENT_ID": "your_client_id",82 "NAVER_CLIENT_SECRET": "your_client_secret"83 }84 }85 }86}87```8889#### Claude Code Configuration9091Add to your Claude Code settings:9293```json94{95 "mcpServers": {96 "naver-search": {97 "command": "npx",98 "args": ["-y", "@isnow890/naver-search-mcp"],99 "env": {100 "NAVER_CLIENT_ID": "your_client_id",101 "NAVER_CLIENT_SECRET": "your_client_secret"102 }103 }104 }105}106```107108### Method 2: Smithery Installation109110Install via Smithery CLI:111112```bash113npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude114```115116### Method 3: Local Installation117118For local development or custom modifications:119120#### Step 1: Download and Build Source Code121122##### Clone with Git123124```bash125git clone https://github.com/isnow890/naver-search-mcp.git126cd naver-search-mcp127npm install128npm run build129```130131##### Or Download ZIP File1321331. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp)1342. Extract the ZIP file to your desired location1353. Navigate to the extracted folder in terminal:136137```bash138cd /path/to/naver-search-mcp139npm install140npm run build141```142143⚠️ **Important**: You must run `npm run build` after installation to generate the `dist` folder that contains the compiled JavaScript files.144145#### Step 2: Claude Desktop Configuration146147After building, you'll need the following information:148149- **NAVER_CLIENT_ID**: Client ID from Naver Developers150- **NAVER_CLIENT_SECRET**: Client Secret from Naver Developers151- **Installation Path**: Absolute path to the downloaded folder152153##### Windows Configuration154155Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`):156157```json158{159 "mcpServers": {160 "naver-search": {161 "type": "stdio",162 "command": "cmd",163 "args": [164 "/c",165 "node",166 "C:\\path\\to\\naver-search-mcp\\dist\\src\\index.js"167 ],168 "cwd": "C:\\path\\to\\naver-search-mcp",169 "env": {170 "NAVER_CLIENT_ID": "your-naver-client-id",171 "NAVER_CLIENT_SECRET": "your-naver-client-secret"172 }173 }174 }175}176```177178##### macOS/Linux Configuration179180Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):181182```json183{184 "mcpServers": {185 "naver-search": {186 "type": "stdio",187 "command": "node",188 "args": ["/path/to/naver-search-mcp/dist/src/index.js"],189 "cwd": "/path/to/naver-search-mcp",190 "env": {191 "NAVER_CLIENT_ID": "your-naver-client-id",192 "NAVER_CLIENT_SECRET": "your-naver-client-secret"193 }194 }195 }196}197```198199##### Path Configuration Important Notes200201⚠️ **Important**: You must change the following paths in the above configuration to your actual installation paths:202203- **Windows**: Change `C:\\path\\to\\naver-search-mcp` to your actual downloaded folder path204- **macOS/Linux**: Change `/path/to/naver-search-mcp` to your actual downloaded folder path205- **Build Path**: Make sure the path points to `dist/src/index.js` (not just `index.js`)206207Finding your path:208209```bash210# Check current location211pwd212213# Absolute path examples214# Windows: C:\Users\username\Downloads\naver-search-mcp215# macOS: /Users/username/Downloads/naver-search-mcp216# Linux: /home/username/Downloads/naver-search-mcp217```218219#### Step 3: Restart Claude Desktop220221After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.222223## Prerequisites224225- Naver Developers API Key (Client ID and Secret)226- Node.js 18 or higher227- NPM 8 or higher228229## License230231MIT License232233---234235## Version History236237### 1.0.47 (2025-01-03)238239- **Added "today" keyword support** for all DataLab date parameters - no need to call separate time tool240- **Fixed server termination issue** - MCP server now properly exits when client disconnects241- **Added graceful shutdown handlers** for SIGINT, SIGTERM, and transport close events242- **Removed get_current_korean_time tool** - redundant with new "today" keyword feature243- **Removed memory monitoring module** - resolved setInterval blocking process exit244- **Special thanks to @gloomyrobot** for reporting the server termination issue245246### 1.0.45 (2025-09-28)247248- Resolved Smithery compatibility issues so you can use the latest features through Smithery249- Replaced the Excel export in category search with JSON for better compatibility250- Restored the `search_webkr` tool for Korean web search251- Fully compatible with Smithery platform installation252253### 1.0.44 (2025-08-31)254255- Added the `get_current_korean_time` tool for essential Korea Standard Time context256- Referenced the time tool across existing tool descriptions for temporal queries257- Improved handling of "today", "now", and "current" searches with temporal context258- Expanded Korean date and time formatting outputs with multiple formats259260### 1.0.40 (2025-08-21)261262- Added the `find_category` tool with fuzzy matching so you no longer need to check category numbers manually in URLs263- Enhanced parameter validation with Zod schema264- Improved the category search workflow265- Implemented a level-based category ranking system that prioritizes top-level categories266267### 1.0.30 (2025-08-04)268269- MCP SDK upgraded to 1.17.1270- Fixed compatibility issues with Smithery specification changes271- Added comprehensive DataLab shopping category code documentation272273### 1.0.2 (2025-04-26)274275- README updated: cafe article search tool and version history section improved276277### 1.0.1 (2025-04-26)278279- Cafe article search feature added280- Shopping category info added to zod281- Source code refactored282283### 1.0.0 (2025-04-08)284285- Initial release286
Full transparency — inspect the skill content before installing.