Skip to main content
Glama
naver-mcp

naver-mcp

by leedw80

naver-mcp

Naver Search API + Datalab API MCP server — 16 tools for Korean web search and trend analysis.

네이버 검색 API + 데이터랩 API를 Claude Code에서 바로 사용할 수 있는 MCP 서버입니다.

Tools (16)

Search (10)

Tool

Description

search_blog

블로그 검색 — 실사용 후기, 개인 경험, 튜토리얼

search_news

뉴스 검색

search_local

지역 업체·장소 검색

search_image

이미지 검색

search_encyc

백과사전 검색

search_cafearticle

카페 게시글 검색

search_kin

지식iN 검색

search_webkr

웹문서 검색

search_adult

성인 여부 판단

search_errata

오타 교정

Datalab (6)

Tool

Description

datalab_search

검색어 트렌드 — 키워드별 상대 검색량 변화

datalab_shopping_category

쇼핑 카테고리별 트렌드

datalab_shopping_keywords

쇼핑 키워드 트렌드

datalab_shopping_keyword_by_age

쇼핑 키워드 연령대별 분석

datalab_shopping_keyword_by_gender

쇼핑 키워드 성별 분석

datalab_shopping_keyword_by_device

쇼핑 키워드 기기별 분석

Related MCP server: korean-keyword-mcp

호출 제한 (Rate Limits)

네이버 오픈 API 공식 호출 한도 (2026-09 확인):

API 그룹

해당 도구

한도

검색

search_* 10종

25,000회/일

데이터랩 검색어트렌드

datalab_search

1,000회/일

데이터랩 쇼핑인사이트

datalab_shopping_* 5종

1,000회/일

  • 한도는 Client ID별로 합산됩니다.

  • 검색 10종은 개별 한도 없이 하나의 25,000회 풀을 공유합니다.

  • 데이터랩은 검색어트렌드 / 쇼핑인사이트가 각각 별도 1,000회 풀입니다 — 이 서버 도구 중 실사용에서 가장 먼저 소진되는 쪽.

스코프 밖 (미포함)

네이버 오픈 API 중 검색·트렌드 목적이 아닌 것은 이 서버에 넣지 않습니다: 네이버 로그인, 회원 프로필 조회, 캡차(이미지/음성), 캘린더, 카페 가입·글쓰기, 공유하기.

Setup

1. Naver API 키 발급

네이버 개발자센터 → 애플리케이션 등록 → Client ID와 Client Secret 발급

2. Claude Code에 추가

~/.claude/settings.json 또는 프로젝트 .claude/settings.json에 추가:

{
  "mcpServers": {
    "naver-mcp": {
      "command": "npx",
      "args": ["-y", "@leedw80/naver-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "YOUR_CLIENT_ID",
        "NAVER_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

3. 재시작

Claude Code를 재시작하면 16개 도구가 활성화됩니다.

쇼핑·책·전문자료 검색(search_shop·search_book·search_doc)은 네이버가 API를 종료해(SE05 존재하지 않는 검색 api) v5.0.0에서 제거했습니다. 쇼핑 트렌드는 datalab_shopping_*로 확인할 수 있습니다.

Environment Variables

Variable

Description

NAVER_CLIENT_ID

네이버 애플리케이션 Client ID

NAVER_CLIENT_SECRET

네이버 애플리케이션 Client Secret

Usage Example

블로그에서 "CCTV 설치 비용" 최신 글 5개 검색해줘
→ search_blog 호출

2024년 1월~6월 "에어컨" vs "선풍기" 검색 트렌드 비교해줘
→ datalab_search 호출

License

MIT

Available Tools

19 tools
datalab_shopping_categoryB

네이버 쇼핑 카테고리 트렌드 — 카테고리별 클릭량 추이를 분석합니다. 시장 규모 파악 및 카테고리 비교에 유용합니다

Inputs: endDate (required), category (required), timeUnit (required), startDate (required), +3 more.

datalab_shopping_keyword_by_ageB

네이버 쇼핑 키워드 연령대별 클릭 비율 — 특정 카테고리 키워드를 연령대별로 누가 더 많이 클릭하는지 분석합니다

Inputs: endDate (required), keyword (required), category (required), timeUnit (required), +3 more.

datalab_shopping_keyword_by_deviceB

네이버 쇼핑 키워드 기기별 클릭 비율 — 특정 카테고리 키워드를 PC/모바일 중 어디서 더 많이 클릭하는지 분석합니다

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

datalab_shopping_keyword_by_genderA

네이버 쇼핑 키워드 성별 클릭 비율 — 특정 카테고리 키워드를 남성/여성 중 누가 더 많이 클릭하는지 분석합니다

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

datalab_shopping_keywordsA

네이버 쇼핑 키워드 트렌드 — 특정 카테고리 내 키워드별 클릭량 추이를 비교합니다. 경쟁 키워드 분석에 유용합니다

Inputs: endDate (required), keyword (required), category (required), timeUnit (required), +4 more.

search_adultA

성인 검색어 판별 — 검색어가 성인 콘텐츠 관련인지 확인합니다. 반환값: adult (0: 일반, 1: 성인)

Inputs: query (required).

search_blogB

네이버 블로그 검색 — 실사용 후기, 개인 경험, 튜토리얼을 검색합니다

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

search_bookB

네이버 책 검색 — 도서 정보, 저자, ISBN, 출판사를 검색합니다

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

search_cafearticleA

네이버 카페 게시글 검색 — 커뮤니티 의견, 경험담, 동호회 정보를 검색합니다

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

search_docA

네이버 전문자료 검색 — 학술자료, 논문, 공문서를 검색합니다

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

search_encycA

네이버 백과사전 검색 — 개념, 용어, 인물 정보를 검색합니다

Inputs: query (required), start, display.

search_errataA

오타 교정 — 검색어의 오타를 교정합니다. 반환값: errata (교정된 검색어)

Inputs: query (required).

search_imageA

네이버 이미지 검색 — 이미지 URL, 썸네일, 출처를 반환합니다

Inputs: query (required), sort, start, filter, +1 more.

search_kinA

네이버 지식iN 검색 — Q&A 형태의 전문 답변, 생활 정보를 검색합니다

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

search_localA

네이버 지역 검색 — 음식점, 상점, 병원 등 장소 정보를 검색합니다. 주소, 전화번호, 카테고리 반환

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

search_newsB

네이버 뉴스 검색 — 최신 뉴스, 시사 이슈, 정책 변화를 검색합니다

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

search_shopA

네이버 쇼핑 검색 — 상품 정보, 가격 비교, 시세 파악에 사용합니다. lprice(최저가), hprice(최고가), mallName(판매처) 반환

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

search_webkrA

네이버 웹 문서 검색 — 공식 사이트, 레퍼런스, 웹 페이지 전반을 검색합니다

Inputs: query (required), start, display.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each search tool targets a distinct Naver vertical (web, blog, news, shop, etc.), and the datalab tools are clearly separated by analysis type. Even potentially similar tools like search_webkr and search_doc are differentiated by their descriptions (general web vs. scholarly/professional materials).

    Naming Consistency4/5

    The majority of tools follow a consistent 'search_<vertical>' pattern, while the datalab group consistently uses 'datalab_<type>'. Minor exceptions include search_adult and search_errata, which are not true searches but use the search_ prefix, causing slight inconsistency.

    Tool Count4/5

    With 19 tools, the server is slightly over the typical 3-15 range, but the scope is broad: it covers many Naver search verticals and data lab analytics. Each tool has a distinct purpose, so the count is justified and not excessive.

    Completeness5/5

    The tool set comprehensively covers Naver's major search APIs (web, blog, news, shop, local, book, encyclopedia, cafe, kin, image, doc) and data lab trend analyses with demographic breakdowns. The only notable omissions are minor search types like video, but core functionality is well-covered.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Korean keyword niche analysis using Naver SearchAd API data for CPC, competition, and search volume, with tools for expansion, scoring, and trend discovery.
      7
      11 npm
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
      12
      1
      ISC
    • A
      license
      B
      quality
      D
      maintenance
      Provides tools to search Naver services (web, news, blog, etc.) and analyze search trends using Naver DataLab, with all required MCP protocol methods implemented for compatibility with Cursor and Claude Desktop.
      20
      8 npm
      MIT