Naver Search

MCP server for Naver Search API integration. Provides comprehensive search capabilities across Naver services (web, news, blog, shopping, etc) and data trend analysis tools via DataLab API.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "isnow890-naver-search-mcp": {
      "command": "node",
      "args": [
        "/path/to/naver-search-mcp/dist/src/index.js"
      ],
      "env": {
        "NAVER_CLIENT_ID": "your_naver_client_id",
        "NAVER_CLIENT_SECRET": "your_naver_client_secret"
      }
    }
  }
}

This MCP server enables you to query the Naver Search APIs and DataLab, letting you perform comprehensive searches across multiple Naver services and analyze data trends from a single, consistent interface. It is designed for easy integration with your MCP clients and supports practical use cases like blog/news searches, shopping trend analysis, and category-based insights.

How to use

You connect to the Naver Search MCP Server from your MCP client (such as Claude Desktop, Cursor AI, or Windsurf) using a ready-made MCP connection configuration. Start the server through the recommended NPX method, then load the server into your client to perform searches and data analyses across Naver services. Use the available tools to search blogs, news, shopping trends, images, and more, and combine them with DataLab trend analyses for comprehensive insights.

How to install

Prerequisites you need before installing the MCP server are a Naver Developers API Key (Client ID and Client Secret) and a Node.js 18 or higher environment with NPM 8 or higher. Optionally, you can run the server inside Docker for containerized deployment.

# NPX Installation (recommended)
# Use in your MCP client configuration as shown below

Additional setup and configuration

Configure your MCP client to use the NPX-based server command and environment variables. The following configuration example is provided for Claude Desktop in JSON form. It sets the MCP server to run via NPX and passes your Naver API credentials as environment variables.

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

Security and credentials

Keep your NAVER_CLIENT_ID and NAVER_CLIENT_SECRET secure. Do not expose these credentials in public repositories or shared configurations. Use environment variables in your MCP client configuration to keep credentials isolated from your code base.

Notes

If you choose to run in other environments, you can adapt the same NPX-based approach to your preferred MCP client. For containerized deployments, you can pass credentials via environment variables in the Docker run command as part of your MCP server configuration.

Tools and capabilities overview

This MCP server exposes a range of search and data analysis tools, including time context utilities, category discovery, and a wide set of Naver search tools across blogs, news, cafes, shopping, images, and knowledge bases, as well as multiple DataLab trend analysis tools. Each tool is designed to help you build end-to-end workflows for market research, digital marketing, and business intelligence.

Troubleshooting

If you encounter issues starting the server with the NPX method, confirm that your NAVER_CLIENT_ID and NAVER_CLIENT_SECRET are correctly set in your MCP client’s environment configuration. Ensure you are using Node.js 18+ and NPM 8+. If you prefer a local build path, ensure you build and point your client to the compiled dist/index.js as appropriate for your environment.

Available tools

find_category

Category search tool with fuzzy matching to identify category IDs from natural language descriptions for trend and shopping insights.

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 using DataLab.

datalab_shopping_category

Analyze shopping category trends with DataLab.

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.

Built by

VeilStrat

AI signals for GTM teams