remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Optional containerization platform for deploying the MCP server in an isolated environment.
Enables comprehensive search across various Naver services (web, news, blogs, shopping, images, KnowledgeiN, books, encyclopedia, academic papers, local places) and data trend analysis through Naver Search API and DataLab API.
Required runtime environment for the MCP server, version 18 or higher needed for server operation.

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.

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

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 @modelcontextprotocol/server-naver-search

Run with Docker

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 :

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

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

Tool Details

Search Tools

Each search tool accepts these parameters:

query : Search term (required)
display : Number of results to show (default: 10)
start : Start position (default: 1)
sort : Sort method (sim: similarity, date: date)

Available search tools:

search_webkr : Search Naver web documents
search_news : Search Naver news
search_blog : Search Naver blogs
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
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date/week/month)
  - keywordGroups : Array of keyword groups
    - groupName : Group name
    - keywords : Array of keywords
datalab_shopping_category
- Shopping Category Trend Analysis
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : An array of shopping category codes and names.
datalab_shopping_by_device
- Device-specific shopping trend analysis
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - device : device type (pc: PC, mo: mobile)
datalab_shopping_by_gender
- Gender shopping trend analysis
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - gender : gender (f: female, m: male)
datalab_shopping_by_age
- Analysis of shopping trends by age group
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - ages : array of age groups (e.g. ["10", "20", "30"])
datalab_shopping_keywords
- Shopping Keyword Trend Analysis
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - keyword : Array of keywords and names
datalab_shopping_keyword_by_device
- Shopping Keyword Trend Analysis by Device
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - keyword : search keyword
  - device : device type (pc: PC, mo: mobile)
datalab_shopping_keyword_by_gender
- Shopping Keyword Gender Trend Analysis
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - keyword : search keyword
  - gender : gender (f: female, m: male)
datalab_shopping_keyword_by_age
- Shopping Keyword Trend Analysis by Age
- Parameters:
  - startDate : Analysis start date (YYYY-MM-DD)
  - endDate : Analysis end date (YYYY-MM-DD)
  - timeUnit : Analysis time unit (date: daily, week: weekly, month: monthly)
  - category : shopping category code
  - keyword : search keyword
  - ages : array of age groups (e.g. ["10", "20", "30"])

Build

Docker build:

docker build -t mcp/naver-search .

License

MIT License

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

An MCP server that enables searching various content types (news, blogs, shopping, images, etc.) through Naver's search API.

Related Resources

Reddit Discussion about this server