naver-search-mcp

Naver Search MCP Server

MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.

Quick Start: Use Without API Key

You can use this server immediately without API keys through Kakao PlayMCP. Simply visit the link and start using it right away!

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_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 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

1. Visit Naver Developers 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, book, cafe article, web, image, kin, encyclopedia, academic, 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 credentials in the configuration below

Installation

Method 1: NPX Installation (Recommended)

The most reliable way to use this MCP server is through NPX. For detailed package information, see the NPM package page.

Claude Desktop Configuration

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):

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Claude Code Configuration

Add to your Claude Code settings:

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Method 2: Smithery Installation

Install via Smithery CLI:

npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude

Method 3: Local Installation

For local development or custom modifications:

Step 1: Download and Build Source Code

Clone with Git

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
2. Extract the ZIP file to your desired location
3. Navigate to the extracted folder in terminal:

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):

{
  "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):

{
  "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

⚠️ 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:

# Check current location
pwd

# 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

After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.

Prerequisites

• Naver Developers API Key (Client ID and Secret)
• Node.js 18 or higher
• NPM 8 or higher

License

MIT License

---

Version History

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 Smithery compatibility issues so you can use the latest features through Smithery
• Replaced the Excel export in category search with JSON for better compatibility
• Restored the search_webkr tool for Korean web search
• Fully compatible with Smithery platform installation

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 Smithery 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