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

• 英文文献（README-en.md）

---

快速设定（快速入门）

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 Search MCP Server

네이버 검색 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 키를 사용하는 경우:

{
  "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) 중 한 쌍을 설정해야 합니다.

---

API 키 발급 안내

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

---

제공 도구 (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)