isnow890/naver-search-mcp

네이버 검색 API 및 DataLab(데이터랩) API 연동을 위한 Model Context Protocol(MCP) 서버입니다.
웹, 뉴스, 블로그, 쇼핑인사이트, 검색어 트렌드 분석 및 자연어 쇼핑 카테고리 검색을 지원합니다.
* English Documentation (README-en.md)
---
빠른 설정 (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 키를 사용하는 경우:
2. 네이버 개발자센터 (기존 발급자 전용)
기존 네이버 개발자센터(openapi.naver.com) 키를 사용하는 경우 (2027-06-30까지 지원):
3. OpenClaw (ClawHub)
OpenClaw를 사용하는 경우 ClawHub 스킬로 즉시 설치할 수 있습니다:
> **참고:** OpenClaw 환경에 NAVER API HUB 쌍(NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY) 또는 개발자센터 쌍(NAVER_CLIENT_ID / NAVER_CLIENT_SECRET) 중 **한 쌍**을 설정해야 합니다.
---
API 키 발급 안내
사용하시는 환경변수 쌍에 따라 호출 플랫폼이 자동으로 결정됩니다. (둘 중 **한 쌍만** 설정하세요)
| 플랫폼 | 환경변수 | 비고 |
|---|---|---|
| **NAVER API HUB (권장)** | NCP_APIGW_API_KEY_ID NCP_APIGW_API_KEY | • 네이버 클라우드 플랫폼 콘솔 접속 • Menu > All Services > Application Services > **NAVER API HUB** > Application 등록 후 '인증 정보' 확인 |
| **네이버 개발자센터 (기존)** | NAVER_CLIENT_ID NAVER_CLIENT_SECRET | • 2026-07-31 부로 신규 발급 차단됨 • 기존 발급된 키는 2027-06-30까지 정상 동작 |
---
제공 도구 (Tools)
1. 카테고리 검색
- **find_category**: 카테고리 번호를 몰라도 자연어로 검색하여 쇼핑 인사이트용 카테고리 ID를 조회합니다.
2. 검색 도구 (Search)
- **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**: 키워드 기기별 트렌드