Skip to main content
Glama
Naver Search MCP Server

Naver Search MCP Server

by isnow890

Naver Search MCP Server

npm version License: MIT

네이버 검색 API 및 DataLab(데이터랩) API 연동을 위한 Model Context Protocol(MCP) 서버입니다.
웹, 뉴스, 블로그, 쇼핑인사이트, 검색어 트렌드 분석 및 자연어 쇼핑 카테고리 검색을 지원합니다.


빠른 설정 (Quick Start)

Claude Desktop, Cursor, Claude Code, Cline 등 사용하시는 MCP 클라이언트 설정 파일(claude_desktop_config.json, mcp.json 등)의 mcpServers에 아래 설정을 추가하세요.

안내: Kakao PlayMCP 연동 서비스는 지원이 종료되었습니다. 로컬 환경에서 직접 API 키를 설정하여 이용해 주세요.

1. NAVER API HUB (권장 / 신규 발급)

네이버 클라우드 플랫폼(NCP)의 NAVER API HUB 키를 사용하는 경우:

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

2. 네이버 개발자센터 (기존 발급자 전용)

기존 네이버 개발자센터(openapi.naver.com) 키를 사용하는 경우 (2027-06-30까지 지원):

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

3. OpenClaw (ClawHub)

OpenClaw를 사용하는 경우 ClawHub 스킬로 즉시 설치할 수 있습니다:

openclaw skills install naver-search-mcp

참고: OpenClaw 환경에 NAVER API HUB 쌍(NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY) 또는 개발자센터 쌍(NAVER_CLIENT_ID / NAVER_CLIENT_SECRET) 중 한 쌍을 설정해야 합니다.


Related MCP server: naver-mcp

API 키 발급 안내

사용하시는 환경변수 쌍에 따라 호출 플랫폼이 자동으로 결정됩니다. (둘 중 한 쌍만 설정하세요)

플랫폼

환경변수

비고

NAVER API HUB (권장)

NCP_APIGW_API_KEY_IDNCP_APIGW_API_KEY

• 네이버 클라우드 플랫폼 콘솔 접속• Menu > All Services > Application Services > NAVER API HUB > Application 등록 후 '인증 정보' 확인

네이버 개발자센터 (기존)

NAVER_CLIENT_IDNAVER_CLIENT_SECRET

• 2026-07-31 부로 신규 발급 차단됨• 기존 발급된 키는 2027-06-30까지 정상 동작


제공 도구 (Tools)

1. 카테고리 검색

  • find_category: 카테고리 번호를 몰라도 자연어로 검색하여 쇼핑 인사이트용 카테고리 ID를 조회합니다.

  • search_webkr: 웹 문서 검색

  • search_news: 뉴스 검색

  • search_blog: 블로그 검색

  • search_cafearticle: 카페 글 검색

  • search_image: 이미지 검색

  • search_kin: 지식iN 검색

  • search_encyc: 백과사전 검색

  • search_local: 지역 장소 검색

3. 데이터랩 트렌드 분석 (DataLab)

날짜 파라미터에 "today" 키워드를 지원합니다 (예: endDate: "today").

  • datalab_search: 검색어 트렌드 분석

  • datalab_shopping_category: 쇼핑 카테고리별 클릭 트렌드

  • datalab_shopping_by_device: 기기별(PC/모바일) 쇼핑 트렌드

  • datalab_shopping_by_gender: 성별 쇼핑 트렌드

  • datalab_shopping_by_age: 연령대별 쇼핑 트렌드

  • datalab_shopping_keywords: 쇼핑 키워드 트렌드

  • datalab_shopping_keyword_by_device: 키워드 기기별 트렌드

  • datalab_shopping_keyword_by_gender: 키워드 성별 트렌드

  • datalab_shopping_keyword_by_age: 키워드 연령별 트렌드


License

MIT License

Available Tools

19 tools
datalab_shopping_by_ageC

Perform a trend analysis on Naver Shopping by age. (네이버 쇼핑 연령별 트렌드 분석)

Inputs: ages (required), category (required), endDate (required), startDate (required), +1 more.

datalab_shopping_by_deviceB

Perform a trend analysis on Naver Shopping by device. (네이버 쇼핑 기기별 트렌드 분석)

Inputs: category (required), device (required), endDate (required), startDate (required), +1 more.

datalab_shopping_by_genderB

Perform a trend analysis on Naver Shopping by gender. (네이버 쇼핑 성별 트렌드 분석)

Inputs: category (required), endDate (required), gender (required), startDate (required), +1 more.

datalab_shopping_categoryB

Perform a trend analysis on Naver Shopping category. (네이버 쇼핑 카테고리별 트렌드 분석)

Inputs: category (required), endDate (required), startDate (required), timeUnit (required).

datalab_shopping_keyword_by_ageB

Perform a trend analysis on Naver Shopping keywords by age. (네이버 쇼핑 키워드 연령별 트렌드 분석)

Inputs: ages (required), category (required), endDate (required), keyword (required), +2 more.

datalab_shopping_keyword_by_deviceC

Perform a trend analysis on Naver Shopping keywords by device. (네이버 쇼핑 키워드 기기별 트렌드 분석)

Inputs: category (required), device (required), endDate (required), keyword (required), +2 more.

datalab_shopping_keyword_by_genderB

Perform a trend analysis on Naver Shopping keywords by gender. (네이버 쇼핑 키워드 성별 트렌드 분석)

Inputs: category (required), endDate (required), gender (required), keyword (required), +2 more.

datalab_shopping_keywordsB

Perform a trend analysis on Naver Shopping keywords. (네이버 쇼핑 키워드별 트렌드 분석)

Inputs: category (required), endDate (required), keyword (required), startDate (required), +1 more.

search_academicC

Perform a search on Naver Academic. (네이버 전문자료 검색)

Inputs: query (required), display, sort, start.

search_blogC

Perform a search on Naver Blog. (네이버 블로그 검색)

Inputs: query (required), display, sort, start.

search_bookC

Perform a search on Naver Book. (네이버 책 검색)

Inputs: query (required), display, sort, start.

search_encycC

Perform a search on Naver Encyclopedia. (네이버 지식백과 검색)

Inputs: query (required), display, sort, start.

search_imageC

Perform a search on Naver Image. (네이버 이미지 검색)

Inputs: query (required), display, sort, start.

search_kinC

Perform a search on Naver KnowledgeiN. (네이버 지식iN 검색)

Inputs: query (required), display, sort, start.

search_localC

Perform a search on Naver Local. (네이버 지역 검색)

Inputs: query (required), display, sort, start.

search_newsC

Perform a search on Naver News. (네이버 뉴스 검색)

Inputs: query (required), display, sort, start.

search_shopC

Perform a search on Naver Shopping. (네이버 쇼핑 검색)

Inputs: query (required), display, sort, start.

search_webkrC

Perform a search on Naver Web Documents. (네이버 웹문서 검색)

Inputs: query (required), display, sort, start.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 19 tools

    Disambiguation4/5

    The tools are clearly organized into two distinct groups: datalab trend analysis tools and search tools for different Naver services. Within each group, tools are differentiated by specific parameters like age, device, gender, or service type, making them mostly distinct. However, some datalab tools might overlap slightly in purpose (e.g., datalab_shopping_keywords and datalab_shopping_keyword_by_* variants), which could cause minor confusion.

    Naming Consistency5/5

    The naming follows a highly consistent pattern: all tools use snake_case with a clear prefix (datalab_ or search_) followed by a descriptive suffix (e.g., _search, _by_age, _blog). This consistency makes it easy to understand the tool's purpose and group at a glance, with no deviations in style or structure.

    Tool Count4/5

    With 19 tools, the count is on the higher side but reasonable for a server covering both search and trend analysis across multiple Naver services. It provides comprehensive coverage without being overwhelming, though it might feel slightly heavy compared to simpler servers. The tools are well-scoped to the domain of Naver's ecosystem.

    Completeness5/5

    The tool set appears complete for the server's purpose of accessing Naver search and trend data. It covers a wide range of Naver services (e.g., Blog, News, Shopping, Academic) with dedicated search tools, and the datalab tools provide detailed trend analysis across various dimensions (age, device, gender, category). There are no obvious gaps in coverage for the stated domain.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.
      14
      115
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
      19
      25 npm
      -
    • A
      license
      C
      quality
      D
      maintenance
      이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
      12
      1
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for the Naver Search Ad API that enables querying campaigns, ad groups, keywords, stats, keyword research, and bid estimates through any MCP client.
      19
      MIT