naver-mcp
Summary: naver-mcp is an MCP server wrapping Naver Search + Datalab APIs, giving Claude Code Korean-language search and trend-analysis capabilities across 19 exposed tools (README documents 16).
Web content search (Korean): web documents (
search_webkr), blogs (search_blog), news (search_news), cafe posts (search_cafearticle), Q&A (search_kin), encyclopedia (search_encyc), images (search_image).Local/place search (
search_local): find restaurants, shops, hospitals — returns address, phone, category.Utilities: check if a query is adult content (
search_adult), correct typos (search_errata).Search tuning: paging via
start/display, sorting (accuracy, date, review, answer-adoption), image size filter.Datalab trend analysis (
datalab_search): compare relative search-volume trends across up to 5 keyword groups (max 20 keywords each), by age/gender/device, with date/week/month granularity.Shopping insights (
datalab_shopping_*): category-level click trends, keyword click-trend comparison within a category, plus age, gender, and device click-share breakdowns.Caveat:
search_shop,search_book,search_docappear in the schema but the README says Naver shut those APIs down (SE05) and they were removed in v5.0.0 — likely non-functional; usedatalab_shopping_*for shopping trends.Limits/auth: requires
NAVER_CLIENT_ID+NAVER_CLIENT_SECRET; 25,000 calls/day shared across search tools, 1,000/day for each Datalab pool.
Provides tools for Korean web search (blog, news, shopping, local, books, etc.) and trend analysis using Naver Search API and Datalab API, enabling query of search results and data trends.
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 |
| 블로그 검색 — 실사용 후기, 개인 경험, 튜토리얼 |
| 뉴스 검색 |
| 지역 업체·장소 검색 |
| 이미지 검색 |
| 백과사전 검색 |
| 카페 게시글 검색 |
| 지식iN 검색 |
| 웹문서 검색 |
| 성인 여부 판단 |
| 오타 교정 |
Datalab (6)
Tool | Description |
| 검색어 트렌드 — 키워드별 상대 검색량 변화 |
| 쇼핑 카테고리별 트렌드 |
| 쇼핑 키워드 트렌드 |
| 쇼핑 키워드 연령대별 분석 |
| 쇼핑 키워드 성별 분석 |
| 쇼핑 키워드 기기별 분석 |
Related MCP server: korean-keyword-mcp
호출 제한 (Rate Limits)
네이버 오픈 API 공식 호출 한도 (2026-09 확인):
API 그룹 | 해당 도구 | 한도 |
검색 |
| 25,000회/일 |
데이터랩 검색어트렌드 |
| 1,000회/일 |
데이터랩 쇼핑인사이트 |
| 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 |
| 네이버 애플리케이션 Client ID |
| 네이버 애플리케이션 Client Secret |
Usage Example
블로그에서 "CCTV 설치 비용" 최신 글 5개 검색해줘
→ search_blog 호출
2024년 1월~6월 "에어컨" vs "선풍기" 검색 트렌드 비교해줘
→ datalab_search 호출License
MIT
Available Tools
19 toolsdatalab_searchA
네이버 데이터랩 검색어 트렌드 — 키워드 그룹별 상대적 검색량 변화를 분석합니다. 마케팅 시즌 파악, 트렌드 비교에 유용합니다
Inputs: endDate (required), timeUnit (required), startDate (required), keywordGroups (required), +3 more.
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
Scored across 19 tools
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).
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.
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.
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
17 data tools in one MCP server, run on Apify: Google Shopping, Flights, Hotels, News, Images, Videos, Ads Transparency, Jobs and Trends; YouTube transcripts; AI visibility checks; Google Maps leads; App Store and Google Play reviews. Pay per result. Sign in with Apify (OAuth) or an API token.
All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
All KR Data tools in one server: Korean business checks, addresses, laws, car flood records & more
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that enables searching various content types (news, blogs, shopping, images, etc.) through Naver's search API.191,678 npm87MIT
- AlicenseAqualityDmaintenanceEnables Korean keyword niche analysis using Naver SearchAd API data for CPC, competition, and search volume, with tools for expansion, scoring, and trend discovery.711 npmMIT
- AlicenseCqualityDmaintenance이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.121ISC
- AlicenseBqualityDmaintenanceProvides 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.208 npmMIT