What is Naver Search Mcp

Naver Search MCP is an integration of Naver Search API and DataLab, designed for comprehensive search capabilities and trend analysis across various Naver services.

Use cases

Use cases include analyzing search trends for specific keywords, comparing product insights from Naver’s shopping data, and enhancing content strategies based on popular search queries.

How to use

To use Naver Search MCP, you need to obtain a Naver Developers API Key, install the server via Smithery or manually set up the environment variables for your Client ID and Secret, and then run the server.

Key features

Key features include integration with multiple Naver APIs for search (blog, news, books) and data trend analysis (Search Trends, Shopping Insight), as well as support for container deployment using Docker.

Where to use

Naver Search MCP can be used in fields such as data analysis, market research, content creation, and any application that requires access to Naver’s search and trend data.

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

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