@isnow890/naver-search-mcp 1.0.50 → 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 +170 -171
- package/dist/src/handlers/category.handlers.js +3 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,154 +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 서비스에서의 종합적인 검색과 데이터 트렌드 분석을 가능하게 합니다.
|
|
6
|
+
|
|
9
7
|
|
|
10
|
-
##
|
|
8
|
+
## 네이버 API 이관 안내 (참고용)
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
네이버가 검색·검색어 트렌드·쇼핑 인사이트 API를 개발자센터에서 네이버 클라우드 플랫폼의 **NAVER API HUB**로 이관합니다. 그와 별개로 검색 API 3종은 완전히 종료됩니다.
|
|
13
11
|
|
|
14
|
-
|
|
|
12
|
+
| 날짜 | 내용 |
|
|
15
13
|
|---|---|
|
|
16
|
-
| **2026-07-31** |
|
|
17
|
-
| **2027-06-30** |
|
|
14
|
+
| **2026-07-31** | 개발자센터에서 **신규** 키 발급 신청이 차단됩니다.<br>쇼핑·책·전문자료 검색 API가 완전히 종료됩니다. |
|
|
15
|
+
| **2027-06-30** | 개발자센터 지원이 종료되어 **기존 키도 사용할 수 없게 됩니다**. |
|
|
18
16
|
|
|
19
|
-
|
|
17
|
+
출처: [네이버 개발자센터 공지 — Search API, Search Trend, Shopping Insight 서비스 종료 및 NAVER API HUB 이관 안내](https://developers.naver.com/notice/article/32530)
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
**처음 설치하시나요?** NAVER API HUB에서 키를 발급받으세요. 개발자센터는 2026-07-31부터 신규 신청을 받지 않으므로 더 이상 시작점이 아닙니다. 발급 절차는 아래 [방법 A: NAVER API HUB](#방법-a-naver-api-hub-권장--앞으로의-방향)에 단계별로 정리해 두었습니다.
|
|
22
20
|
|
|
23
|
-
|
|
21
|
+
**이미 개발자센터 키로 쓰고 계신가요?** 바꿀 것이 없습니다. 2027-06-30까지 그대로 동작하고, 이 버전은 두 플랫폼을 같은 설치본에서 지원합니다. 이관하실 때가 되면 HUB 키를 발급받아 환경변수 두 개만 바꾸면 되고, 그 외에 손댈 것은 없습니다.
|
|
24
22
|
|
|
25
|
-
|
|
23
|
+
**이 서버의 지원 계획:** 네이버가 정한 2027-06-30까지는 두 플랫폼을 나란히 지원합니다. 개발자센터 경로는 그 날짜가 지나 누구에게도 동작할 수 없게 된 뒤에야 별도 메이저 버전에서 제거합니다. 그때까지는 버전을 올려도 쓰고 계신 설정이 끊기는 일은 없습니다.
|
|
26
24
|
|
|
27
|
-
**
|
|
25
|
+
**1.0.49에서 툴 3개가 제거되었습니다**: `search_shop`, `search_book`, `search_academic`. 네이버가 2026-07-31에 해당 검색 API를 종료하며 어느 플랫폼에도 대체 API가 없어서, 이 서버가 살려둘 방법이 없습니다. 쇼핑 **인사이트**(`datalab_shopping_*`)와 `find_category`는 *별개의* API이므로 영향받지 **않습니다**.
|
|
28
26
|
|
|
29
|
-
##
|
|
27
|
+
## OpenClaw용 ClawHub 지원
|
|
30
28
|
|
|
31
|
-
|
|
29
|
+
이 MCP 서버는 ClawHub에 OpenClaw skill로 배포되어 있습니다:
|
|
32
30
|
|
|
33
31
|
```bash
|
|
34
32
|
openclaw skills install naver-search-mcp
|
|
35
33
|
```
|
|
36
34
|
|
|
37
|
-
|
|
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 변수를 환경에 직접 설정하세요.
|
|
38
36
|
|
|
39
|
-
##
|
|
37
|
+
## ~~빠른 시작: API 키 없이 사용하기 (종료)~~
|
|
40
38
|
|
|
41
|
-
|
|
39
|
+
> **안내:** 네이버 API 정책 변경(2026.09)에 따라 [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154) 즉시 사용 서비스는 종료되었습니다.
|
|
42
40
|
|
|
43
|
-
##
|
|
41
|
+
## 도구 세부 정보
|
|
44
42
|
|
|
45
|
-
###
|
|
43
|
+
### 사용 가능한 도구:
|
|
46
44
|
|
|
47
|
-
#### 🆕
|
|
45
|
+
#### 🆕 카테고리 검색
|
|
48
46
|
|
|
49
|
-
- **find_category**:
|
|
47
|
+
- **find_category**: 카테고리 검색 도구 - 이제 트렌드와 쇼핑 인사이트 검색을 위하여 카테고리 번호를 url로 일일히 찾을 필요가 없습니다. 편하게 자연어로 검색하세요.
|
|
50
48
|
|
|
51
|
-
####
|
|
49
|
+
#### 검색 도구
|
|
52
50
|
|
|
53
|
-
- **search_webkr**:
|
|
54
|
-
- **search_news**:
|
|
55
|
-
- **search_blog**:
|
|
56
|
-
- **search_cafearticle**:
|
|
57
|
-
- **search_image**:
|
|
58
|
-
- **search_kin**:
|
|
59
|
-
- **search_encyc**:
|
|
60
|
-
- **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**: 지역 장소 검색
|
|
61
59
|
|
|
62
|
-
> **
|
|
63
|
-
>
|
|
64
|
-
>
|
|
65
|
-
> 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이며 영향받지 않습니다.
|
|
66
63
|
|
|
67
|
-
#### DataLab
|
|
64
|
+
#### DataLab 도구
|
|
68
65
|
|
|
69
|
-
- **datalab_search**:
|
|
70
|
-
- **datalab_shopping_category**:
|
|
71
|
-
- **datalab_shopping_by_device**:
|
|
72
|
-
- **datalab_shopping_by_gender**:
|
|
73
|
-
- **datalab_shopping_by_age**:
|
|
74
|
-
- **datalab_shopping_keywords**:
|
|
75
|
-
- **datalab_shopping_keyword_by_device**:
|
|
76
|
-
- **datalab_shopping_keyword_by_gender**:
|
|
77
|
-
- **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**: 쇼핑 키워드 연령별 트렌드 분석
|
|
78
75
|
|
|
79
|
-
##
|
|
76
|
+
## API 키 얻기
|
|
80
77
|
|
|
81
|
-
|
|
82
|
-
|
|
78
|
+
이 서버는 두 플랫폼 중 하나에서 키를 발급받아 사용합니다. 환경변수 **한 쌍만** 설정하세요 —
|
|
79
|
+
어느 쌍을 설정하는지에 따라 사용되는 플랫폼이 정해지는 원리는 아래 [설정](#설정)을 참고하세요.
|
|
83
80
|
|
|
84
|
-
###
|
|
81
|
+
### 방법 A: NAVER API HUB (권장 — 앞으로의 방향)
|
|
85
82
|
|
|
86
|
-
1.
|
|
87
|
-
2.
|
|
88
|
-
3.
|
|
89
|
-
4.
|
|
90
|
-
5.
|
|
91
|
-
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`로 사용하세요
|
|
92
89
|
|
|
93
|
-
###
|
|
90
|
+
### 방법 B: 네이버 개발자센터 (기존 — 기존 키 보유자 전용)
|
|
94
91
|
|
|
95
|
-
>
|
|
96
|
-
>
|
|
97
|
-
>
|
|
92
|
+
> 네이버 개발자센터는 **2026-07-31**부터 신규 애플리케이션 등록을 받지 않습니다.
|
|
93
|
+
> 이 플랫폼의 Client ID/Secret이 아직 없다면 위 NAVER API HUB를 이용하세요.
|
|
94
|
+
> 기존에 발급받은 개발자센터 키는 2027-06-30까지 계속 동작합니다.
|
|
98
95
|
|
|
99
|
-
1.
|
|
100
|
-
2.
|
|
101
|
-
3.
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
4.
|
|
105
|
-
-
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
5.
|
|
109
|
-
6.
|
|
110
|
-
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`로 사용하세요
|
|
111
108
|
|
|
112
|
-
##
|
|
109
|
+
## 설정
|
|
113
110
|
|
|
114
|
-
###
|
|
111
|
+
### 자격증명
|
|
115
112
|
|
|
116
|
-
|
|
117
|
-
|
|
113
|
+
두 플랫폼을 지원합니다. **한 쌍만** 설정하세요. 키 문자열만으로는 어느 플랫폼 키인지
|
|
114
|
+
구분할 수 없기 때문에, 어느 환경변수에 넣었는지로 플랫폼을 판단합니다.
|
|
118
115
|
|
|
119
|
-
|
|
|
116
|
+
| 환경변수 | 플랫폼 | 호출 대상 |
|
|
120
117
|
|---|---|---|
|
|
121
118
|
| `NCP_APIGW_API_KEY_ID`, `NCP_APIGW_API_KEY` | NAVER API HUB (NCP) | `naverapihub.apigw.ntruss.com` |
|
|
122
|
-
| `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` |
|
|
119
|
+
| `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` | 네이버 개발자센터 (기존) | `openapi.naver.com` |
|
|
123
120
|
|
|
124
|
-
|
|
121
|
+
두 쌍을 모두 설정하면 NAVER API HUB를 사용합니다.
|
|
125
122
|
|
|
126
|
-
|
|
127
|
-
|
|
123
|
+
아래 설치 예시는 기존 `NAVER_CLIENT_ID` / `NAVER_CLIENT_SECRET` 쌍을 사용합니다.
|
|
124
|
+
NAVER API HUB 키를 가지고 있다면 위 표의 HUB 쌍으로 바꿔 넣으세요.
|
|
128
125
|
|
|
129
|
-
###
|
|
126
|
+
### NAVER API HUB 이관 안내
|
|
130
127
|
|
|
131
|
-
|
|
128
|
+
네이버는 이 API들을 개발자센터에서 네이버 클라우드 플랫폼의 NAVER API HUB로 이관하고 있습니다.
|
|
132
129
|
|
|
133
|
-
|
|
|
130
|
+
| 날짜 | 내용 |
|
|
134
131
|
|---|---|
|
|
135
|
-
| 2026-06-25 | NAVER API HUB
|
|
136
|
-
| 2026-07-31 |
|
|
137
|
-
| 2027-06-30 |
|
|
132
|
+
| 2026-06-25 | NAVER API HUB 출시 |
|
|
133
|
+
| 2026-07-31 | 개발자센터 신규 신청 차단 |
|
|
134
|
+
| 2027-06-30 | 개발자센터 지원 종료 — 기존 키도 사용 불가 |
|
|
138
135
|
|
|
139
|
-
|
|
140
|
-
NAVER
|
|
141
|
-
|
|
136
|
+
기존 키는 2027-06-30까지 그대로 동작합니다. 이관하려면 네이버 클라우드 플랫폼 콘솔에서
|
|
137
|
+
NAVER API HUB 키를 발급받아 `NCP_APIGW_API_KEY_ID` / `NCP_APIGW_API_KEY`에 넣으세요.
|
|
138
|
+
개발자센터 키는 NAVER API HUB에서 사용할 수 없습니다.
|
|
142
139
|
|
|
143
|
-
##
|
|
140
|
+
## 설치
|
|
144
141
|
|
|
145
|
-
###
|
|
142
|
+
### 방법 1: NPX 설치 (권장)
|
|
146
143
|
|
|
147
|
-
|
|
144
|
+
이 MCP 서버를 사용하는 가장 안정적인 방법은 NPX 직접 설치입니다. 자세한 패키지 정보는 [NPM 패키지 페이지](https://www.npmjs.com/package/@isnow890/naver-search-mcp)를 참조하세요.
|
|
148
145
|
|
|
149
|
-
#### Claude Desktop
|
|
146
|
+
#### Claude Desktop 설정
|
|
150
147
|
|
|
151
|
-
|
|
148
|
+
Claude Desktop 설정 파일에 다음을 추가하세요 (Windows: `%APPDATA%\Claude\claude_desktop_config.json`, macOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json`):
|
|
152
149
|
|
|
153
150
|
```json
|
|
154
151
|
{
|
|
@@ -165,9 +162,9 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
|
|
|
165
162
|
}
|
|
166
163
|
```
|
|
167
164
|
|
|
168
|
-
#### Claude Code
|
|
165
|
+
#### Claude Code 설정
|
|
169
166
|
|
|
170
|
-
|
|
167
|
+
Claude Code 설정에 다음을 추가하세요:
|
|
171
168
|
|
|
172
169
|
```json
|
|
173
170
|
{
|
|
@@ -184,29 +181,29 @@ Add to your Claude Code settings:
|
|
|
184
181
|
}
|
|
185
182
|
```
|
|
186
183
|
|
|
187
|
-
###
|
|
184
|
+
### 방법 2: OpenClaw용 ClawHub 설치
|
|
188
185
|
|
|
189
|
-
|
|
186
|
+
이 MCP 서버는 ClawHub skill wrapper를 통해 OpenClaw에서도 사용할 수 있습니다. 다음 명령으로 설치하세요:
|
|
190
187
|
|
|
191
188
|
```bash
|
|
192
189
|
openclaw skills install naver-search-mcp
|
|
193
190
|
```
|
|
194
191
|
|
|
195
|
-
|
|
192
|
+
ClawHub skill은 내부적으로 동일한 npm 패키지를 사용합니다:
|
|
196
193
|
|
|
197
194
|
```bash
|
|
198
195
|
npx -y @isnow890/naver-search-mcp
|
|
199
196
|
```
|
|
200
197
|
|
|
201
|
-
|
|
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 변수를 직접 설정하세요.
|
|
202
199
|
|
|
203
|
-
###
|
|
200
|
+
### 방법 3: 로컬 설치
|
|
204
201
|
|
|
205
|
-
|
|
202
|
+
로컬 개발이나 커스텀 수정이 필요한 경우:
|
|
206
203
|
|
|
207
|
-
####
|
|
204
|
+
#### 1단계: 소스 코드 다운로드 및 빌드
|
|
208
205
|
|
|
209
|
-
#####
|
|
206
|
+
##### Git으로 클론하기
|
|
210
207
|
|
|
211
208
|
```bash
|
|
212
209
|
git clone https://github.com/isnow890/naver-search-mcp.git
|
|
@@ -215,11 +212,11 @@ npm install
|
|
|
215
212
|
npm run build
|
|
216
213
|
```
|
|
217
214
|
|
|
218
|
-
#####
|
|
215
|
+
##### 또는 ZIP 파일로 다운로드
|
|
219
216
|
|
|
220
|
-
1.
|
|
221
|
-
2.
|
|
222
|
-
3.
|
|
217
|
+
1. [GitHub 릴리스 페이지](https://github.com/isnow890/naver-search-mcp/)에서 최신 버전을 다운로드
|
|
218
|
+
2. ZIP 파일을 원하는 위치에 압축 해제
|
|
219
|
+
3. 터미널에서 압축 해제된 폴더로 이동:
|
|
223
220
|
|
|
224
221
|
```bash
|
|
225
222
|
cd /path/to/naver-search-mcp
|
|
@@ -227,19 +224,19 @@ npm install
|
|
|
227
224
|
npm run build
|
|
228
225
|
```
|
|
229
226
|
|
|
230
|
-
⚠️
|
|
227
|
+
⚠️ **중요**: 설치 후 반드시 `npm run build`를 실행하여 컴파일된 JavaScript 파일이 포함된 `dist` 폴더를 생성해야 합니다.
|
|
231
228
|
|
|
232
|
-
####
|
|
229
|
+
#### 2단계: Claude Desktop 설정
|
|
233
230
|
|
|
234
|
-
|
|
231
|
+
빌드 완료 후 다음 정보가 필요합니다:
|
|
235
232
|
|
|
236
|
-
- **NAVER_CLIENT_ID**:
|
|
237
|
-
- **NAVER_CLIENT_SECRET**:
|
|
238
|
-
-
|
|
233
|
+
- **NAVER_CLIENT_ID**: Naver Developers에서 발급받은 클라이언트 ID
|
|
234
|
+
- **NAVER_CLIENT_SECRET**: Naver Developers에서 발급받은 클라이언트 시크릿
|
|
235
|
+
- **설치 경로**: 다운로드한 폴더의 절대 경로
|
|
239
236
|
|
|
240
|
-
##### Windows
|
|
237
|
+
##### Windows 설정
|
|
241
238
|
|
|
242
|
-
|
|
239
|
+
Claude Desktop 설정 파일(`%APPDATA%\Claude\claude_desktop_config.json`)에 다음을 추가:
|
|
243
240
|
|
|
244
241
|
```json
|
|
245
242
|
{
|
|
@@ -262,9 +259,9 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
|
|
|
262
259
|
}
|
|
263
260
|
```
|
|
264
261
|
|
|
265
|
-
##### macOS/Linux
|
|
262
|
+
##### macOS/Linux 설정
|
|
266
263
|
|
|
267
|
-
|
|
264
|
+
Claude Desktop 설정 파일(`~/Library/Application Support/Claude/claude_desktop_config.json`)에 다음을 추가:
|
|
268
265
|
|
|
269
266
|
```json
|
|
270
267
|
{
|
|
@@ -283,102 +280,104 @@ Add to Claude Desktop config file (`~/Library/Application Support/Claude/claude_
|
|
|
283
280
|
}
|
|
284
281
|
```
|
|
285
282
|
|
|
286
|
-
#####
|
|
283
|
+
##### 경로 설정 주의사항
|
|
287
284
|
|
|
288
|
-
⚠️
|
|
285
|
+
⚠️ **중요**: 위 설정에서 다음 경로들을 실제 설치 경로로 변경해야 합니다:
|
|
289
286
|
|
|
290
|
-
- **Windows**:
|
|
291
|
-
- **macOS/Linux**:
|
|
292
|
-
-
|
|
287
|
+
- **Windows**: `C:\\path\\to\\naver-search-mcp`를 실제 다운로드한 폴더 경로로 변경
|
|
288
|
+
- **macOS/Linux**: `/path/to/naver-search-mcp`를 실제 다운로드한 폴더 경로로 변경
|
|
289
|
+
- **빌드 경로**: 경로가 `dist/src/index.js`를 가리키는지 확인 (`index.js`만이 아님)
|
|
293
290
|
|
|
294
|
-
|
|
291
|
+
경로 찾기:
|
|
295
292
|
|
|
296
293
|
```bash
|
|
297
|
-
#
|
|
294
|
+
# 현재 위치 확인
|
|
298
295
|
pwd
|
|
299
296
|
|
|
300
|
-
#
|
|
301
|
-
# Windows: C:\Users
|
|
302
|
-
# macOS: /Users
|
|
303
|
-
# 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
|
|
304
301
|
```
|
|
305
302
|
|
|
306
|
-
####
|
|
303
|
+
#### 3단계: Claude Desktop 재시작
|
|
307
304
|
|
|
308
|
-
|
|
305
|
+
설정 완료 후 Claude Desktop을 완전히 종료하고 다시 시작하면 Naver Search MCP 서버가 활성화됩니다.
|
|
309
306
|
|
|
310
|
-
##
|
|
307
|
+
## 필수 요구 사항
|
|
311
308
|
|
|
312
|
-
-
|
|
313
|
-
- Node.js 18
|
|
314
|
-
- NPM 8
|
|
309
|
+
- 두 플랫폼 중 하나의 자격증명 — NAVER API HUB 또는 Naver Developers ([API 키 얻기](#api-키-얻기) 참고)
|
|
310
|
+
- Node.js 18 이상
|
|
311
|
+
- NPM 8 이상
|
|
315
312
|
|
|
316
|
-
##
|
|
313
|
+
## 라이선스
|
|
317
314
|
|
|
318
|
-
MIT
|
|
315
|
+
MIT 라이선스
|
|
319
316
|
|
|
320
317
|
---
|
|
321
318
|
|
|
322
|
-
##
|
|
319
|
+
## 버전 히스토리
|
|
323
320
|
|
|
324
321
|
### 1.0.49 (2026-07-26)
|
|
325
322
|
|
|
326
|
-
- NAVER API HUB
|
|
327
|
-
-
|
|
328
|
-
- API
|
|
329
|
-
-
|
|
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일 때는 키를 다른 플랫폼 변수에 넣지 않았는지 확인하도록 안내합니다
|
|
330
327
|
|
|
331
328
|
### 1.0.48 (2026-05-12)
|
|
332
329
|
|
|
333
|
-
-
|
|
334
|
-
-
|
|
330
|
+
- `npx`로 실행될 때 현재 작업 디렉터리가 달라도 `find_category`가 카테고리 데이터를 정상적으로 읽도록 수정
|
|
331
|
+
- 카테고리 데이터를 설치된 패키지 위치 기준으로 먼저 찾고, 로컬 개발 경로는 fallback으로 사용하도록 변경
|
|
335
332
|
|
|
336
333
|
### 1.0.47 (2025-01-03)
|
|
337
334
|
|
|
338
|
-
- **
|
|
339
|
-
-
|
|
340
|
-
-
|
|
341
|
-
- **
|
|
342
|
-
-
|
|
343
|
-
-
|
|
335
|
+
- **"today" 키워드 지원 추가** - 모든 DataLab 날짜 파라미터에서 별도 시간 도구 호출 불필요
|
|
336
|
+
- **서버 종료 문제 해결** - 클라이언트 연결 해제 시 MCP 서버가 정상적으로 종료
|
|
337
|
+
- **정상 종료 핸들러 추가** - SIGINT, SIGTERM, 전송 닫기 이벤트 처리
|
|
338
|
+
- **get_current_korean_time 도구 제거** - "today" 키워드 기능으로 중복 제거
|
|
339
|
+
- **메모리 모니터링 모듈 제거** - setInterval로 인한 프로세스 종료 방지 문제 해결
|
|
340
|
+
- **@gloomyrobot님께 감사** - 서버 종료 문제를 보고해주셔서 해결할 수 있었습니다
|
|
344
341
|
|
|
345
342
|
### 1.0.45 (2025-09-28)
|
|
346
343
|
|
|
347
|
-
-
|
|
348
|
-
-
|
|
349
|
-
-
|
|
350
|
-
-
|
|
344
|
+
- 호스팅 MCP 설치 환경 호환성 문제 해결
|
|
345
|
+
- 카테고리 검색에서 엑셀 호환성 문제 해결 - JSON 기능으로 교체
|
|
346
|
+
- 웹 한국어 검색(`search_webkr`) 기능 복구
|
|
347
|
+
- 호스팅 플랫폼 설치 호환성 개선
|
|
351
348
|
|
|
352
349
|
### 1.0.44 (2025-08-31)
|
|
353
350
|
|
|
354
|
-
-
|
|
355
|
-
-
|
|
356
|
-
-
|
|
357
|
-
-
|
|
351
|
+
- `get_current_korean_time` 도구 추가 - 한국 시간대를 위한 필수 시간 컨텍스트 도구
|
|
352
|
+
- 시간적 쿼리를 위한 시간 도구 참조로 모든 기존 도구 설명 강화
|
|
353
|
+
- "오늘", "지금", "현재" 검색을 위한 시간적 컨텍스트 처리 개선
|
|
354
|
+
- 다양한 출력 형식의 포괄적인 한국어 시간 포맷팅
|
|
358
355
|
|
|
359
356
|
### 1.0.40 (2025-08-21)
|
|
360
357
|
|
|
361
|
-
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
-
|
|
358
|
+
- `find_category` 도구 추가
|
|
359
|
+
**이제 트렌드와 쇼핑 인사이트 검색을 위하여 카테고리 번호를 url로 일일히 찾을 필요가 없습니다. 편하게 자연어로 검색하세요.**
|
|
360
|
+
|
|
361
|
+
- Zod 스키마 기반 매개변수 검증 강화
|
|
362
|
+
- 카테고리 검색 워크플로우 개선
|
|
363
|
+
- 레벨 기반 카테고리 순위 시스템 구현 (대분류 우선)
|
|
365
364
|
|
|
366
365
|
### 1.0.30 (2025-08-04)
|
|
367
366
|
|
|
368
|
-
- MCP SDK
|
|
369
|
-
-
|
|
370
|
-
-
|
|
367
|
+
- MCP SDK 1.17.1로 업그레이드
|
|
368
|
+
- 호스팅 MCP 플랫폼 스펙 변경으로 인한 호환성 오류 수정
|
|
369
|
+
- DataLab 쇼핑 카테고리 코드 상세 문서화 추가
|
|
371
370
|
|
|
372
371
|
### 1.0.2 (2025-04-26)
|
|
373
372
|
|
|
374
|
-
- README
|
|
373
|
+
- README 업데이트: 카페글 검색 도구 및 버전 히스토리 안내 개선
|
|
375
374
|
|
|
376
375
|
### 1.0.1 (2025-04-26)
|
|
377
376
|
|
|
378
|
-
-
|
|
379
|
-
-
|
|
380
|
-
-
|
|
377
|
+
- 카페글 검색 기능 추가
|
|
378
|
+
- zod에 쇼핑 카테고리 정보 추가
|
|
379
|
+
- 소스코드 리팩토링
|
|
381
380
|
|
|
382
381
|
### 1.0.0 (2025-04-08)
|
|
383
382
|
|
|
384
|
-
-
|
|
383
|
+
- 오픈오픈
|
|
@@ -185,9 +185,9 @@ export const findCategoryHandler = async ({ query, max_results = 10 }) => {
|
|
|
185
185
|
})),
|
|
186
186
|
next_steps: {
|
|
187
187
|
trend_analysis: `이제 datalab_shopping_category 도구로 각 카테고리의 트렌드 분석이 가능합니다`,
|
|
188
|
-
age_analysis: `
|
|
189
|
-
gender_analysis: `
|
|
190
|
-
device_analysis: `
|
|
188
|
+
age_analysis: `datalab_shopping_by_age 도구로 연령별 쇼핑 패턴을 분석할 수 있습니다`,
|
|
189
|
+
gender_analysis: `datalab_shopping_by_gender 도구로 성별 쇼핑 패턴을 분석할 수 있습니다`,
|
|
190
|
+
device_analysis: `datalab_shopping_by_device 도구로 디바이스별 쇼핑 패턴을 분석할 수 있습니다`
|
|
191
191
|
}
|
|
192
192
|
};
|
|
193
193
|
return responseData;
|