# naver-mcp

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

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

## Tools (19)

### Search (13)

| Tool | Description |
|------|-------------|
| `search_blog` | 블로그 검색 — 실사용 후기, 개인 경험, 튜토리얼 |
| `search_news` | 뉴스 검색 |
| `search_shop` | 쇼핑 상품 검색 |
| `search_local` | 지역 업체·장소 검색 |
| `search_book` | 도서 검색 |
| `search_image` | 이미지 검색 |
| `search_encyc` | 백과사전 검색 |
| `search_cafearticle` | 카페 게시글 검색 |
| `search_kin` | 지식iN 검색 |
| `search_webkr` | 웹문서 검색 |
| `search_doc` | 전문자료 검색 |
| `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` | 쇼핑 키워드 기기별 분석 |

## 호출 제한 (Rate Limits)

네이버 오픈 API [공식 호출 한도](https://developers.naver.com/products/intro/plan/plan.md) (2026-09 확인):

| API 그룹 | 해당 도구 | 한도 |
|---------|---------|------|
| 검색 | `search_*` 13종 | **25,000회/일** |
| 데이터랩 검색어트렌드 | `datalab_search` | **1,000회/일** |
| 데이터랩 쇼핑인사이트 | `datalab_shopping_*` 5종 | **1,000회/일** |

- 한도는 Client ID별로 합산됩니다.
- 검색 13종은 개별 한도 없이 하나의 25,000회 풀을 공유합니다.
- 데이터랩은 검색어트렌드 / 쇼핑인사이트가 각각 별도 1,000회 풀입니다 — 이 서버 도구 중 실사용에서 가장 먼저 소진되는 쪽.

### 스코프 밖 (미포함)

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

## Setup

### 1. Naver API 키 발급

[네이버 개발자센터](https://developers.naver.com/apps/#/register) → 애플리케이션 등록 → `Client ID`와 `Client Secret` 발급

### 2. Claude Code에 추가

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

```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를 재시작하면 19개 도구가 활성화됩니다.

## 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