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.

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

Visit Naver Developers
Click "Register Application"
Enter application name and select ALL of the following APIs:
- Search (for blog, news, book search, etc.)
- DataLab (Search Trends)
- DataLab (Shopping Insight)
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:

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

For Cursor:

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

For Windsurf:

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

For Cline:

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

# 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

npx @isnow890/naver-search-mcp

Run with Docker

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:

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

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

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

docker build -t mcp/naver-search .

License

MIT License

Naver Search MCP Server

Integrations