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

• MCP SDK upgraded to 1.17.1
• Fixed compatibility issues with Smithery specification changes
• Added comprehensive DataLab shopping category code documentation

• README updated: cafe article search tool and version history section improved

• Cafe article search feature added
• Shopping category info added to zod
• Source code refactored

• Initial release

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.

• Naver Developers API Key (Client ID and Secret)
• Node.js 18 or higher
• NPM 8 or higher
• Docker (optional, for container deployment)

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

• 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

For DataLab shopping analysis tools, you need to use specific 8-digit category codes. Here are some common examples:

• 50000000: Fashion/Clothing (패션의류)
• 50000002: Cosmetics/Beauty (화장품/미용)
• 50000003: Digital/Home Appliances (디지털/가전)
• 50000004: Sports/Leisure (스포츠/레저)
• 50000005: Automotive/Tools (자동차/공구)
• 50000006: Books/Music/DVDs (도서/음반/DVD)
• 50000007: Toys/Hobbies (완구/취미)
• 50000008: Food/Beverages (식품/음료)
• 50000009: Health/Medical (건강/의료용품)
• 50000010: Household/Living (생활/주방용품)

1. Visit Naver Shopping
2. Navigate to desired category
3. Check the cat_id parameter in the URL
4. Use the 8-digit code (e.g., cat_id=50000000 → use "50000000")

When using shopping category tools, specify category like:

{
  "category": "50000000",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "timeUnit": "month"
}

For a complete list of category codes, you can download from Naver Shopping Partner Center or extract them by browsing Naver Shopping categories.

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

# 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

npx @isnow890/naver-search-mcp

docker run -i --rm \
  -e NAVER_CLIENT_ID=your_client_id \
  -e NAVER_CLIENT_SECRET=your_client_secret \
  mcp/naver-search

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

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

Docker build:

docker build -t mcp/naver-search .

MIT License