@isnow890/naver-search-mcp 1.0.51 → 1.0.52
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +169 -181
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,165 +1,151 @@
|
|
|
1
1
|
# Naver Search MCP Server
|
|
2
2
|
|
|
3
|
-
[](README-ko.md)
|
|
4
|
-
|
|
5
|
-
[](https://archestra.ai/mcp-catalog/isnow890__naver-search-mcp)
|
|
6
3
|
[](https://mcp.so/server/naver-search-mcp/isnow890)
|
|
7
4
|
|
|
8
|
-
|
|
5
|
+
Naver 검색 API와 DataLab API 통합을 위한 MCP 서버로, 다양한 Naver 서비스에서의 종합적인 검색과 데이터 트렌드 분석을 가능하게 합니다.
|
|
9
6
|
|
|
10
|
-
> [!WARNING]
|
|
11
|
-
> ### ⚠️ [Archived] Project Discontinuation & Service End Notice
|
|
12
|
-
>
|
|
13
|
-
> Due to changes in Naver's API policies and terms of service, **active development and maintenance of this repository have been officially discontinued, and this repository is now archived (read-only)**.
|
|
14
|
-
>
|
|
15
|
-
> - **End of Maintenance**: No new features, bug fixes, issues, or pull requests will be supported.
|
|
16
|
-
> - **Kakao PlayMCP Discontinuation**: The zero-setup Kakao PlayMCP service integration has also been shut down.
|
|
17
|
-
> - **Code Preservation**: Existing code remains publicly available for reference and study under the MIT License.
|
|
18
|
-
>
|
|
19
|
-
> Thank you very much to everyone who supported, starred, and used `naver-search-mcp` throughout this project! 🙏
|
|
20
7
|
|
|
21
|
-
##
|
|
8
|
+
## 네이버 API 이관 안내 (참고용)
|
|
22
9
|
|
|
23
|
-
|
|
10
|
+
네이버가 검색·검색어 트렌드·쇼핑 인사이트 API를 개발자센터에서 네이버 클라우드 플랫폼의 **NAVER API HUB**로 이관합니다. 그와 별개로 검색 API 3종은 완전히 종료됩니다.
|
|
24
11
|
|
|
25
|
-
|
|
|
12
|
+
| 날짜 | 내용 |
|
|
26
13
|
|---|---|
|
|
27
|
-
| **2026-07-31** |
|
|
28
|
-
| **2027-06-30** |
|
|
14
|
+
| **2026-07-31** | 개발자센터에서 **신규** 키 발급 신청이 차단됩니다.<br>쇼핑·책·전문자료 검색 API가 완전히 종료됩니다. |
|
|
15
|
+
| **2027-06-30** | 개발자센터 지원이 종료되어 **기존 키도 사용할 수 없게 됩니다**. |
|
|
29
16
|
|
|
30
|
-
|
|
17
|
+
출처: [네이버 개발자센터 공지 — Search API, Search Trend, Shopping Insight 서비스 종료 및 NAVER API HUB 이관 안내](https://developers.naver.com/notice/article/32530)
|
|
31
18
|
|
|
32
|
-
|
|
19
|
+
**처음 설치하시나요?** NAVER API HUB에서 키를 발급받으세요. 개발자센터는 2026-07-31부터 신규 신청을 받지 않으므로 더 이상 시작점이 아닙니다. 발급 절차는 아래 [방법 A: NAVER API HUB](#방법-a-naver-api-hub-권장--앞으로의-방향)에 단계별로 정리해 두었습니다.
|
|
33
20
|
|
|
34
|
-
|
|
21
|
+
**이미 개발자센터 키로 쓰고 계신가요?** 바꿀 것이 없습니다. 2027-06-30까지 그대로 동작하고, 이 버전은 두 플랫폼을 같은 설치본에서 지원합니다. 이관하실 때가 되면 HUB 키를 발급받아 환경변수 두 개만 바꾸면 되고, 그 외에 손댈 것은 없습니다.
|
|
35
22
|
|
|
36
|
-
|
|
23
|
+
**이 서버의 지원 계획:** 네이버가 정한 2027-06-30까지는 두 플랫폼을 나란히 지원합니다. 개발자센터 경로는 그 날짜가 지나 누구에게도 동작할 수 없게 된 뒤에야 별도 메이저 버전에서 제거합니다. 그때까지는 버전을 올려도 쓰고 계신 설정이 끊기는 일은 없습니다.
|
|
37
24
|
|
|
38
|
-
**
|
|
25
|
+
**1.0.49에서 툴 3개가 제거되었습니다**: `search_shop`, `search_book`, `search_academic`. 네이버가 2026-07-31에 해당 검색 API를 종료하며 어느 플랫폼에도 대체 API가 없어서, 이 서버가 살려둘 방법이 없습니다. 쇼핑 **인사이트**(`datalab_shopping_*`)와 `find_category`는 *별개의* API이므로 영향받지 **않습니다**.
|
|
39
26
|
|
|
40
|
-
##
|
|
27
|
+
## OpenClaw용 ClawHub 지원
|
|
41
28
|
|
|
42
|
-
|
|
29
|
+
이 MCP 서버는 ClawHub에 OpenClaw skill로 배포되어 있습니다:
|
|
43
30
|
|
|
44
31
|
```bash
|
|
45
32
|
openclaw skills install naver-search-mcp
|
|
46
33
|
```
|
|
47
34
|
|
|
48
|
-
|
|
35
|
+
ClawHub skill은 내부적으로 npm에 배포된 패키지를 사용하며, OpenClaw 환경에 **한 쌍**의 자격증명을 설정해야 합니다 — NAVER API HUB 쌍(`NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`) 또는 개발자센터 쌍(`NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`) 중 하나입니다. OpenClaw의 `apiKey` 필드는 `NAVER_CLIENT_SECRET`에 매핑되므로, HUB 사용자는 `apiKey` 대신 두 HUB 변수를 환경에 직접 설정하세요.
|
|
49
36
|
|
|
50
|
-
##
|
|
37
|
+
## ~~빠른 시작: API 키 없이 사용하기 (종료)~~
|
|
51
38
|
|
|
52
|
-
>
|
|
39
|
+
> **안내:** 네이버 API 정책 변경(2026.09)에 따라 [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154) 즉시 사용 서비스는 종료되었습니다.
|
|
53
40
|
|
|
54
|
-
##
|
|
41
|
+
## 도구 세부 정보
|
|
55
42
|
|
|
56
|
-
###
|
|
43
|
+
### 사용 가능한 도구:
|
|
57
44
|
|
|
58
|
-
#### 🆕
|
|
45
|
+
#### 🆕 카테고리 검색
|
|
59
46
|
|
|
60
|
-
- **find_category**:
|
|
47
|
+
- **find_category**: 카테고리 검색 도구 - 이제 트렌드와 쇼핑 인사이트 검색을 위하여 카테고리 번호를 url로 일일히 찾을 필요가 없습니다. 편하게 자연어로 검색하세요.
|
|
61
48
|
|
|
62
|
-
####
|
|
49
|
+
#### 검색 도구
|
|
63
50
|
|
|
64
|
-
- **search_webkr**:
|
|
65
|
-
- **search_news**:
|
|
66
|
-
- **search_blog**:
|
|
67
|
-
- **search_cafearticle**:
|
|
68
|
-
- **search_image**:
|
|
69
|
-
- **search_kin**:
|
|
70
|
-
- **search_encyc**:
|
|
71
|
-
- **search_local**:
|
|
51
|
+
- **search_webkr**: 웹 문서 검색
|
|
52
|
+
- **search_news**: 뉴스 검색
|
|
53
|
+
- **search_blog**: 블로그 검색
|
|
54
|
+
- **search_cafearticle**: 카페글 검색
|
|
55
|
+
- **search_image**: 이미지 검색
|
|
56
|
+
- **search_kin**: 지식iN 검색
|
|
57
|
+
- **search_encyc**: 백과사전 검색
|
|
58
|
+
- **search_local**: 지역 장소 검색
|
|
72
59
|
|
|
73
|
-
> **
|
|
74
|
-
>
|
|
75
|
-
>
|
|
76
|
-
> Shopping **Insight** (`datalab_shopping_*`) is a different API and is unaffected.
|
|
60
|
+
> **1.0.49에서 제거됨:** `search_shop`, `search_book`, `search_academic`
|
|
61
|
+
> 네이버는 2026-07-31에 쇼핑·책·전문자료 검색 API를 종료하며 대체 API가 없습니다.
|
|
62
|
+
> 쇼핑 **인사이트**(`datalab_shopping_*`)는 별개의 API이며 영향받지 않습니다.
|
|
77
63
|
|
|
78
|
-
#### DataLab
|
|
64
|
+
#### DataLab 도구
|
|
79
65
|
|
|
80
|
-
- **datalab_search**:
|
|
81
|
-
- **datalab_shopping_category**:
|
|
82
|
-
- **datalab_shopping_by_device**:
|
|
83
|
-
- **datalab_shopping_by_gender**:
|
|
84
|
-
- **datalab_shopping_by_age**:
|
|
85
|
-
- **datalab_shopping_keywords**:
|
|
86
|
-
- **datalab_shopping_keyword_by_device**:
|
|
87
|
-
- **datalab_shopping_keyword_by_gender**:
|
|
88
|
-
- **datalab_shopping_keyword_by_age**:
|
|
66
|
+
- **datalab_search**: 검색어 트렌드 분석
|
|
67
|
+
- **datalab_shopping_category**: 쇼핑 카테고리 트렌드 분석
|
|
68
|
+
- **datalab_shopping_by_device**: 기기별 쇼핑 트렌드 분석
|
|
69
|
+
- **datalab_shopping_by_gender**: 성별 쇼핑 트렌드 분석
|
|
70
|
+
- **datalab_shopping_by_age**: 연령대별 쇼핑 트렌드 분석
|
|
71
|
+
- **datalab_shopping_keywords**: 쇼핑 키워드 트렌드 분석
|
|
72
|
+
- **datalab_shopping_keyword_by_device**: 쇼핑 키워드 기기별 트렌드 분석
|
|
73
|
+
- **datalab_shopping_keyword_by_gender**: 쇼핑 키워드 성별 트렌드 분석
|
|
74
|
+
- **datalab_shopping_keyword_by_age**: 쇼핑 키워드 연령별 트렌드 분석
|
|
89
75
|
|
|
90
|
-
##
|
|
76
|
+
## API 키 얻기
|
|
91
77
|
|
|
92
|
-
|
|
93
|
-
|
|
78
|
+
이 서버는 두 플랫폼 중 하나에서 키를 발급받아 사용합니다. 환경변수 **한 쌍만** 설정하세요 —
|
|
79
|
+
어느 쌍을 설정하는지에 따라 사용되는 플랫폼이 정해지는 원리는 아래 [설정](#설정)을 참고하세요.
|
|
94
80
|
|
|
95
|
-
###
|
|
81
|
+
### 방법 A: NAVER API HUB (권장 — 앞으로의 방향)
|
|
96
82
|
|
|
97
|
-
1.
|
|
98
|
-
2.
|
|
99
|
-
3.
|
|
100
|
-
4.
|
|
101
|
-
5.
|
|
102
|
-
6.
|
|
83
|
+
1. [네이버 클라우드 플랫폼 콘솔](https://www.ncloud.com)에서 회원가입하거나 로그인
|
|
84
|
+
2. 콘솔 화면 우측 상단의 리전 & 플랫폼 선택 버튼을 클릭해 이용 중인 리전과 플랫폼을 선택한 후 **적용** 클릭
|
|
85
|
+
3. **Menu > All Services > Application Services > [NAVER API HUB](https://www.ncloud.com/product/applicationService/naverApiHub)** 클릭
|
|
86
|
+
4. 좌측의 **Application** 메뉴를 클릭하고 애플리케이션을 선택(또는 생성)한 다음, API 관리 하위의 **인증 정보** 버튼 클릭
|
|
87
|
+
5. 팝업 창에 표시된 **Client ID**와 **Client Secret** 복사
|
|
88
|
+
6. 아래 설정에서 Client ID는 `NCP_APIGW_API_KEY_ID`로, Client Secret은 `NCP_APIGW_API_KEY`로 사용하세요
|
|
103
89
|
|
|
104
|
-
###
|
|
90
|
+
### 방법 B: 네이버 개발자센터 (기존 — 기존 키 보유자 전용)
|
|
105
91
|
|
|
106
|
-
>
|
|
107
|
-
>
|
|
108
|
-
>
|
|
92
|
+
> 네이버 개발자센터는 **2026-07-31**부터 신규 애플리케이션 등록을 받지 않습니다.
|
|
93
|
+
> 이 플랫폼의 Client ID/Secret이 아직 없다면 위 NAVER API HUB를 이용하세요.
|
|
94
|
+
> 기존에 발급받은 개발자센터 키는 2027-06-30까지 계속 동작합니다.
|
|
109
95
|
|
|
110
|
-
1.
|
|
111
|
-
2.
|
|
112
|
-
3.
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
4.
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
5.
|
|
120
|
-
6.
|
|
121
|
-
7.
|
|
96
|
+
1. [Naver Developers](https://developers.naver.com/apps/#/register)에 방문하여 네이버 계정으로 로그인
|
|
97
|
+
2. "애플리케이션 등록" 버튼 클릭
|
|
98
|
+
3. 애플리케이션 정보 입력:
|
|
99
|
+
- **애플리케이션 이름**: 원하는 이름 입력 (예: "Naver Search MCP")
|
|
100
|
+
- **사용 API**: "검색" 선택
|
|
101
|
+
4. API 설정에서 다음 API를 **모두 체크**:
|
|
102
|
+
- **검색** - 블로그, 뉴스, 카페글, 웹문서, 이미지, 지식iN, 백과사전, 지역 검색에 필요
|
|
103
|
+
- **데이터랩 - 검색어 트렌드** - 검색어 트렌드 분석에 필요
|
|
104
|
+
- **데이터랩 - 쇼핑인사이트** - 쇼핑 트렌드 분석에 필요
|
|
105
|
+
5. "등록하기" 버튼 클릭하여 등록 완료
|
|
106
|
+
6. 등록 완료 후 애플리케이션 상세 페이지에서 **Client ID**와 **Client Secret** 확인
|
|
107
|
+
7. 아래 설정에서 `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`로 사용하세요
|
|
122
108
|
|
|
123
|
-
##
|
|
109
|
+
## 설정
|
|
124
110
|
|
|
125
|
-
###
|
|
111
|
+
### 자격증명
|
|
126
112
|
|
|
127
|
-
|
|
128
|
-
|
|
113
|
+
두 플랫폼을 지원합니다. **한 쌍만** 설정하세요. 키 문자열만으로는 어느 플랫폼 키인지
|
|
114
|
+
구분할 수 없기 때문에, 어느 환경변수에 넣었는지로 플랫폼을 판단합니다.
|
|
129
115
|
|
|
130
|
-
|
|
|
116
|
+
| 환경변수 | 플랫폼 | 호출 대상 |
|
|
131
117
|
|---|---|---|
|
|
132
118
|
| `NCP_APIGW_API_KEY_ID`, `NCP_APIGW_API_KEY` | NAVER API HUB (NCP) | `naverapihub.apigw.ntruss.com` |
|
|
133
|
-
| `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` |
|
|
119
|
+
| `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` | 네이버 개발자센터 (기존) | `openapi.naver.com` |
|
|
134
120
|
|
|
135
|
-
|
|
121
|
+
두 쌍을 모두 설정하면 NAVER API HUB를 사용합니다.
|
|
136
122
|
|
|
137
|
-
|
|
138
|
-
|
|
123
|
+
아래 설치 예시는 기존 `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET` 쌍을 사용합니다.
|
|
124
|
+
NAVER API HUB 키를 가지고 있다면 위 표의 HUB 쌍으로 바꿔 넣으세요.
|
|
139
125
|
|
|
140
|
-
###
|
|
126
|
+
### NAVER API HUB 이관 안내
|
|
141
127
|
|
|
142
|
-
|
|
128
|
+
네이버는 이 API들을 개발자센터에서 네이버 클라우드 플랫폼의 NAVER API HUB로 이관하고 있습니다.
|
|
143
129
|
|
|
144
|
-
|
|
|
130
|
+
| 날짜 | 내용 |
|
|
145
131
|
|---|---|
|
|
146
|
-
| 2026-06-25 | NAVER API HUB
|
|
147
|
-
| 2026-07-31 |
|
|
148
|
-
| 2027-06-30 |
|
|
132
|
+
| 2026-06-25 | NAVER API HUB 출시 |
|
|
133
|
+
| 2026-07-31 | 개발자센터 신규 신청 차단 |
|
|
134
|
+
| 2027-06-30 | 개발자센터 지원 종료 — 기존 키도 사용 불가 |
|
|
149
135
|
|
|
150
|
-
|
|
151
|
-
NAVER
|
|
152
|
-
|
|
136
|
+
기존 키는 2027-06-30까지 그대로 동작합니다. 이관하려면 네이버 클라우드 플랫폼 콘솔에서
|
|
137
|
+
NAVER API HUB 키를 발급받아 `NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`에 넣으세요.
|
|
138
|
+
개발자센터 키는 NAVER API HUB에서 사용할 수 없습니다.
|
|
153
139
|
|
|
154
|
-
##
|
|
140
|
+
## 설치
|
|
155
141
|
|
|
156
|
-
###
|
|
142
|
+
### 방법 1: NPX 설치 (권장)
|
|
157
143
|
|
|
158
|
-
|
|
144
|
+
이 MCP 서버를 사용하는 가장 안정적인 방법은 NPX 직접 설치입니다. 자세한 패키지 정보는 [NPM 패키지 페이지](https://www.npmjs.com/package/@isnow890/naver-search-mcp)를 참조하세요.
|
|
159
145
|
|
|
160
|
-
#### Claude Desktop
|
|
146
|
+
#### Claude Desktop 설정
|
|
161
147
|
|
|
162
|
-
|
|
148
|
+
Claude Desktop 설정 파일에 다음을 추가하세요 (Windows: `%APPDATA%\Claude\claude_desktop_config.json`, macOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json`):
|
|
163
149
|
|
|
164
150
|
```json
|
|
165
151
|
{
|
|
@@ -176,9 +162,9 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
|
|
|
176
162
|
}
|
|
177
163
|
```
|
|
178
164
|
|
|
179
|
-
#### Claude Code
|
|
165
|
+
#### Claude Code 설정
|
|
180
166
|
|
|
181
|
-
|
|
167
|
+
Claude Code 설정에 다음을 추가하세요:
|
|
182
168
|
|
|
183
169
|
```json
|
|
184
170
|
{
|
|
@@ -195,29 +181,29 @@ Add to your Claude Code settings:
|
|
|
195
181
|
}
|
|
196
182
|
```
|
|
197
183
|
|
|
198
|
-
###
|
|
184
|
+
### 방법 2: OpenClaw용 ClawHub 설치
|
|
199
185
|
|
|
200
|
-
|
|
186
|
+
이 MCP 서버는 ClawHub skill wrapper를 통해 OpenClaw에서도 사용할 수 있습니다. 다음 명령으로 설치하세요:
|
|
201
187
|
|
|
202
188
|
```bash
|
|
203
189
|
openclaw skills install naver-search-mcp
|
|
204
190
|
```
|
|
205
191
|
|
|
206
|
-
|
|
192
|
+
ClawHub skill은 내부적으로 동일한 npm 패키지를 사용합니다:
|
|
207
193
|
|
|
208
194
|
```bash
|
|
209
195
|
npx -y @isnow890/naver-search-mcp
|
|
210
196
|
```
|
|
211
197
|
|
|
212
|
-
|
|
198
|
+
사용 전에 OpenClaw 환경에 **한 쌍**의 자격증명을 설정해야 합니다 — NAVER API HUB 쌍(`NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`) 또는 개발자센터 쌍(`NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`). OpenClaw의 `apiKey`는 `NAVER_CLIENT_SECRET`에 매핑되므로, HUB 사용자는 `apiKey` 대신 두 HUB 변수를 직접 설정하세요.
|
|
213
199
|
|
|
214
|
-
###
|
|
200
|
+
### 방법 3: 로컬 설치
|
|
215
201
|
|
|
216
|
-
|
|
202
|
+
로컬 개발이나 커스텀 수정이 필요한 경우:
|
|
217
203
|
|
|
218
|
-
####
|
|
204
|
+
#### 1단계: 소스 코드 다운로드 및 빌드
|
|
219
205
|
|
|
220
|
-
#####
|
|
206
|
+
##### Git으로 클론하기
|
|
221
207
|
|
|
222
208
|
```bash
|
|
223
209
|
git clone https://github.com/isnow890/naver-search-mcp.git
|
|
@@ -226,11 +212,11 @@ npm install
|
|
|
226
212
|
npm run build
|
|
227
213
|
```
|
|
228
214
|
|
|
229
|
-
#####
|
|
215
|
+
##### 또는 ZIP 파일로 다운로드
|
|
230
216
|
|
|
231
|
-
1.
|
|
232
|
-
2.
|
|
233
|
-
3.
|
|
217
|
+
1. [GitHub 릴리스 페이지](https://github.com/isnow890/naver-search-mcp/)에서 최신 버전을 다운로드
|
|
218
|
+
2. ZIP 파일을 원하는 위치에 압축 해제
|
|
219
|
+
3. 터미널에서 압축 해제된 폴더로 이동:
|
|
234
220
|
|
|
235
221
|
```bash
|
|
236
222
|
cd /path/to/naver-search-mcp
|
|
@@ -238,19 +224,19 @@ npm install
|
|
|
238
224
|
npm run build
|
|
239
225
|
```
|
|
240
226
|
|
|
241
|
-
⚠️
|
|
227
|
+
⚠️ **중요**: 설치 후 반드시 `npm run build`를 실행하여 컴파일된 JavaScript 파일이 포함된 `dist` 폴더를 생성해야 합니다.
|
|
242
228
|
|
|
243
|
-
####
|
|
229
|
+
#### 2단계: Claude Desktop 설정
|
|
244
230
|
|
|
245
|
-
|
|
231
|
+
빌드 완료 후 다음 정보가 필요합니다:
|
|
246
232
|
|
|
247
|
-
- **NAVER_CLIENT_ID**:
|
|
248
|
-
- **NAVER_CLIENT_SECRET**:
|
|
249
|
-
-
|
|
233
|
+
- **NAVER_CLIENT_ID**: Naver Developers에서 발급받은 클라이언트 ID
|
|
234
|
+
- **NAVER_CLIENT_SECRET**: Naver Developers에서 발급받은 클라이언트 시크릿
|
|
235
|
+
- **설치 경로**: 다운로드한 폴더의 절대 경로
|
|
250
236
|
|
|
251
|
-
##### Windows
|
|
237
|
+
##### Windows 설정
|
|
252
238
|
|
|
253
|
-
|
|
239
|
+
Claude Desktop 설정 파일(`%APPDATA%\Claude\claude_desktop_config.json`)에 다음을 추가:
|
|
254
240
|
|
|
255
241
|
```json
|
|
256
242
|
{
|
|
@@ -273,9 +259,9 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
|
|
|
273
259
|
}
|
|
274
260
|
```
|
|
275
261
|
|
|
276
|
-
##### macOS/Linux
|
|
262
|
+
##### macOS/Linux 설정
|
|
277
263
|
|
|
278
|
-
|
|
264
|
+
Claude Desktop 설정 파일(`~/Library/Application Support/Claude/claude_desktop_config.json`)에 다음을 추가:
|
|
279
265
|
|
|
280
266
|
```json
|
|
281
267
|
{
|
|
@@ -294,102 +280,104 @@ Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_
|
|
|
294
280
|
}
|
|
295
281
|
```
|
|
296
282
|
|
|
297
|
-
#####
|
|
283
|
+
##### 경로 설정 주의사항
|
|
298
284
|
|
|
299
|
-
⚠️
|
|
285
|
+
⚠️ **중요**: 위 설정에서 다음 경로들을 실제 설치 경로로 변경해야 합니다:
|
|
300
286
|
|
|
301
|
-
- **Windows**:
|
|
302
|
-
- **macOS/Linux**:
|
|
303
|
-
-
|
|
287
|
+
- **Windows**: `C:\\path\\to\\naver-search-mcp`를 실제 다운로드한 폴더 경로로 변경
|
|
288
|
+
- **macOS/Linux**: `/path/to/naver-search-mcp`를 실제 다운로드한 폴더 경로로 변경
|
|
289
|
+
- **빌드 경로**: 경로가 `dist/src/index.js`를 가리키는지 확인 (`index.js`만이 아님)
|
|
304
290
|
|
|
305
|
-
|
|
291
|
+
경로 찾기:
|
|
306
292
|
|
|
307
293
|
```bash
|
|
308
|
-
#
|
|
294
|
+
# 현재 위치 확인
|
|
309
295
|
pwd
|
|
310
296
|
|
|
311
|
-
#
|
|
312
|
-
# Windows: C:\Users
|
|
313
|
-
# macOS: /Users
|
|
314
|
-
# Linux: /home
|
|
297
|
+
# 절대 경로 예시
|
|
298
|
+
# Windows: C:\Users\홍길동\Downloads\naver-search-mcp
|
|
299
|
+
# macOS: /Users/홍길동/Downloads/naver-search-mcp
|
|
300
|
+
# Linux: /home/홍길동/Downloads/naver-search-mcp
|
|
315
301
|
```
|
|
316
302
|
|
|
317
|
-
####
|
|
303
|
+
#### 3단계: Claude Desktop 재시작
|
|
318
304
|
|
|
319
|
-
|
|
305
|
+
설정 완료 후 Claude Desktop을 완전히 종료하고 다시 시작하면 Naver Search MCP 서버가 활성화됩니다.
|
|
320
306
|
|
|
321
|
-
##
|
|
307
|
+
## 필수 요구 사항
|
|
322
308
|
|
|
323
|
-
-
|
|
324
|
-
- Node.js 18
|
|
325
|
-
- NPM 8
|
|
309
|
+
- 두 플랫폼 중 하나의 자격증명 — NAVER API HUB 또는 Naver Developers ([API 키 얻기](#api-키-얻기) 참고)
|
|
310
|
+
- Node.js 18 이상
|
|
311
|
+
- NPM 8 이상
|
|
326
312
|
|
|
327
|
-
##
|
|
313
|
+
## 라이선스
|
|
328
314
|
|
|
329
|
-
MIT
|
|
315
|
+
MIT 라이선스
|
|
330
316
|
|
|
331
317
|
---
|
|
332
318
|
|
|
333
|
-
##
|
|
319
|
+
## 버전 히스토리
|
|
334
320
|
|
|
335
321
|
### 1.0.49 (2026-07-26)
|
|
336
322
|
|
|
337
|
-
- NAVER API HUB
|
|
338
|
-
-
|
|
339
|
-
- API
|
|
340
|
-
-
|
|
323
|
+
- NAVER API HUB 지원: `NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`를 설정하면 새 플랫폼으로 호출합니다. 기존 `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET`은 그대로 동작하며, 어느 변수 쌍을 설정했는지로 플랫폼이 결정됩니다
|
|
324
|
+
- `search_shop`, `search_book`, `search_academic` **제거**. 네이버가 2026-07-31에 해당 검색 API를 종료하며 어느 플랫폼에도 대체가 없습니다
|
|
325
|
+
- API 에러가 raw `AxiosError` 대신 일반 `Error`로 던져집니다. `error.response?.status`로 분기하던 코드는 `undefined`를 보게 되며, 같은 정보는 `Error.message`에 담깁니다
|
|
326
|
+
- 에러 메시지에 플랫폼과 HTTP 상태가 표시되고, 401일 때는 키를 다른 플랫폼 변수에 넣지 않았는지 확인하도록 안내합니다
|
|
341
327
|
|
|
342
328
|
### 1.0.48 (2026-05-12)
|
|
343
329
|
|
|
344
|
-
-
|
|
345
|
-
-
|
|
330
|
+
- `npx`로 실행될 때 현재 작업 디렉터리가 달라도 `find_category`가 카테고리 데이터를 정상적으로 읽도록 수정
|
|
331
|
+
- 카테고리 데이터를 설치된 패키지 위치 기준으로 먼저 찾고, 로컬 개발 경로는 fallback으로 사용하도록 변경
|
|
346
332
|
|
|
347
333
|
### 1.0.47 (2025-01-03)
|
|
348
334
|
|
|
349
|
-
- **
|
|
350
|
-
-
|
|
351
|
-
-
|
|
352
|
-
- **
|
|
353
|
-
-
|
|
354
|
-
-
|
|
335
|
+
- **"today" 키워드 지원 추가** - 모든 DataLab 날짜 파라미터에서 별도 시간 도구 호출 불필요
|
|
336
|
+
- **서버 종료 문제 해결** - 클라이언트 연결 해제 시 MCP 서버가 정상적으로 종료
|
|
337
|
+
- **정상 종료 핸들러 추가** - SIGINT, SIGTERM, 전송 닫기 이벤트 처리
|
|
338
|
+
- **get_current_korean_time 도구 제거** - "today" 키워드 기능으로 중복 제거
|
|
339
|
+
- **메모리 모니터링 모듈 제거** - setInterval로 인한 프로세스 종료 방지 문제 해결
|
|
340
|
+
- **@gloomyrobot님께 감사** - 서버 종료 문제를 보고해주셔서 해결할 수 있었습니다
|
|
355
341
|
|
|
356
342
|
### 1.0.45 (2025-09-28)
|
|
357
343
|
|
|
358
|
-
-
|
|
359
|
-
-
|
|
360
|
-
-
|
|
361
|
-
-
|
|
344
|
+
- 호스팅 MCP 설치 환경 호환성 문제 해결
|
|
345
|
+
- 카테고리 검색에서 엑셀 호환성 문제 해결 - JSON 기능으로 교체
|
|
346
|
+
- 웹 한국어 검색(`search_webkr`) 기능 복구
|
|
347
|
+
- 호스팅 플랫폼 설치 호환성 개선
|
|
362
348
|
|
|
363
349
|
### 1.0.44 (2025-08-31)
|
|
364
350
|
|
|
365
|
-
-
|
|
366
|
-
-
|
|
367
|
-
-
|
|
368
|
-
-
|
|
351
|
+
- `get_current_korean_time` 도구 추가 - 한국 시간대를 위한 필수 시간 컨텍스트 도구
|
|
352
|
+
- 시간적 쿼리를 위한 시간 도구 참조로 모든 기존 도구 설명 강화
|
|
353
|
+
- "오늘", "지금", "현재" 검색을 위한 시간적 컨텍스트 처리 개선
|
|
354
|
+
- 다양한 출력 형식의 포괄적인 한국어 시간 포맷팅
|
|
369
355
|
|
|
370
356
|
### 1.0.40 (2025-08-21)
|
|
371
357
|
|
|
372
|
-
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
-
|
|
358
|
+
- `find_category` 도구 추가
|
|
359
|
+
**이제 트렌드와 쇼핑 인사이트 검색을 위하여 카테고리 번호를 url로 일일히 찾을 필요가 없습니다. 편하게 자연어로 검색하세요.**
|
|
360
|
+
|
|
361
|
+
- Zod 스키마 기반 매개변수 검증 강화
|
|
362
|
+
- 카테고리 검색 워크플로우 개선
|
|
363
|
+
- 레벨 기반 카테고리 순위 시스템 구현 (대분류 우선)
|
|
376
364
|
|
|
377
365
|
### 1.0.30 (2025-08-04)
|
|
378
366
|
|
|
379
|
-
- MCP SDK
|
|
380
|
-
-
|
|
381
|
-
-
|
|
367
|
+
- MCP SDK 1.17.1로 업그레이드
|
|
368
|
+
- 호스팅 MCP 플랫폼 스펙 변경으로 인한 호환성 오류 수정
|
|
369
|
+
- DataLab 쇼핑 카테고리 코드 상세 문서화 추가
|
|
382
370
|
|
|
383
371
|
### 1.0.2 (2025-04-26)
|
|
384
372
|
|
|
385
|
-
- README
|
|
373
|
+
- README 업데이트: 카페글 검색 도구 및 버전 히스토리 안내 개선
|
|
386
374
|
|
|
387
375
|
### 1.0.1 (2025-04-26)
|
|
388
376
|
|
|
389
|
-
-
|
|
390
|
-
-
|
|
391
|
-
-
|
|
377
|
+
- 카페글 검색 기능 추가
|
|
378
|
+
- zod에 쇼핑 카테고리 정보 추가
|
|
379
|
+
- 소스코드 리팩토링
|
|
392
380
|
|
|
393
381
|
### 1.0.0 (2025-04-08)
|
|
394
382
|
|
|
395
|
-
-
|
|
383
|
+
- 오픈오픈
|