内容
# 네이버 API MCP 服务器
네이버购物洞察API和搜索API整合提供的MCP(Model Context Protocol)服务器。
## 功能
### 购物洞察 API (DataLab)
#### 类别趋势查询
- `get-category-trends`: 查询各类别趋势（最多3个类别）
- `get-category-by-device`: 查询特定类别的设备趋势
- `get-category-by-gender`: 查询特定类别的性别趋势
- `get-category-by-age`: 查询特定类别的年龄趋势
#### 关键词趋势查询
- `get-keyword-trends`: 查询各关键词趋势（最多5个关键词）
- `get-keyword-by-device`: 查询特定关键词的设备趋势
- `get-keyword-by-gender`: 查询特定关键词的性别趋势
- `get-keyword-by-age`: 查询特定关键词的年龄趋势
### 搜索 API
- `search-blog`: 博客搜索
- `search-kin`: 지식iN搜索
- `search-shopping`: 购物搜索
- `search-encyclopedia`: 百科全书搜索
## 安装
### 从源码安装
```bash
# 克隆仓库
git clone https://github.com/dataartai/naver-api-mcp.git
cd naver-api-mcp
# 安装依赖
npm install
# 构建
npm run build
```
## 配置
1. 在 네이버开发者中心（https://developers.naver.com）注册应用程序并获取客户端ID和密钥。
- **购物洞察 API**: DataLab > 购物洞察 API 申请
- **搜索 API**: 搜索 API 申请
2. 设置环境变量:
**方法 1: 使用 `.env` 文件（本地开发）**
```env
NAVER_CLIENT_ID=your-client-id
NAVER_CLIENT_SECRET=your-client-secret
```
**方法 2: 在 MCP 配置文件中直接设置**
```json
{
"mcpServers": {
"naver-api": {
"command": "node",
"args": [
"path/to/naver-api-mcp/dist/index.js"
],
"env": {
"NAVER_CLIENT_ID": "YOUR-CLIENT-ID",
"NAVER_CLIENT_SECRET": "YOUR-CLIENT-SECRET"
}
}
}
}
```
## 使用方法
### 直接执行
```bash
npm start
```
### Claude Desktop 配置
要在Claude Desktop中使用，请在以下配置文件中添加：
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"naver-api": {
"command": "node",
"args": [
"D:\\OneDrive\\Cursorhome\\naver-api-mcp\\dist\\index.js"
],
"cwd": "D:\\OneDrive\\Cursorhome\\naver-api-mcp",
"env": {
"NAVER_CLIENT_ID": "YOUR-CLIENT-ID",
"NAVER_CLIENT_SECRET": "YOUR-CLIENT-SECRET"
}
}
}
}
```
> **注意**: 请将路径替换为实际项目路径。
## MCP 工具使用指南
### 购物洞察 API 工具
#### 类别趋势查询
**`get-category-trends`**: 查询多个类别的趋势
- `startDate`: 开始日期（YYYY-MM-DD）
- `endDate`: 结束日期（YYYY-MM-DD）
- `timeUnit`: 时间单位（`date`, `week`, `month`）
- `categories`: 类别数组（最多3个）
- `device`: 设备过滤器（`pc`, `mobile`, `all`）- 可选
- `gender`: 性别过滤器（`m`, `f`, `a`）- 可选
- `ages`: 年龄段数组（`10`, `20`, `30`, `40`, `50`, `60`）- 可选
**`get-category-by-device`**: 查询特定类别的设备趋势
- `category`: 类别ID（例如 `50000000`）
**`get-category-by-gender`**: 查询特定类别的性别趋势
- `category`: 类别ID
**`get-category-by-age`**: 查询特定类别的年龄趋势
- `category`: 类别ID
#### 关键词趋势查询
**`get-keyword-trends`**: 查询多个关键词的趋势
- `category`: 类别ID
- `keywords`: 关键词数组（最多5个）
**`get-keyword-by-device`**: 查询特定关键词的设备趋势
- `category`: 类别ID
- `keyword`: 搜索关键词
**`get-keyword-by-gender`**: 查询特定关键词的性别趋势
- `category`: 类别ID
- `keyword`: 搜索关键词
**`get-keyword-by-age`**: 查询特定关键词的年龄趋势
- `category`: 类别ID
- `keyword`: 搜索关键词
### 搜索 API 工具
#### 博客搜索 (`search-blog`)
- `query`: 搜索词（必填）
- `display`: 每页显示结果数（1-100，默认：10）
- `start`: 搜索起始位置（1-1000，默认：1）
- `sort`: 排序方式（`sim`: 精确度顺序，`date`: 日期顺序）
#### 지식iN 搜索 (`search-kin`)
- `query`: 搜索词（必填）
- `display`: 每页显示结果数（1-100，默认：10）
- `start`: 搜索起始位置（1-1000，默认：1）
- `sort`: 排序方式（`sim`: 精确度顺序，`date`: 日期顺序，`point`: 评分顺序）
#### 购物搜索 (`search-shopping`)
- `query`: 搜索词（必填）
- `display`: 每页显示结果数（1-100，默认：10）
- `start`: 搜索起始位置（1-1000，默认：1）
- `sort`: 排序方式（`sim`: 精确度顺序，`date`: 日期顺序，`asc`: 价格升序，`dsc`: 价格降序）
- `filter`: 过滤器（`naverpay`: 仅限 네이버페이 商品）- 可选
- `exclude`: 排除商品类型（`used`: 二手，`rental`: 租赁，`cbshop`: 海外直购）- 可选
#### 百科全书搜索 (`search-encyclopedia`)
- `query`: 搜索词（必填）
- `display`: 每页显示结果数（1-100，默认：10）
- `start`: 搜索起始位置（1-1000，默认：1）
## 主要类别 ID
- 时尚服装: `50000000`
- 化妆品/美容: `50000002`
- 数字/家电: `50000003`
- 食品: `50000008`
## API 限制
### 购物洞察 API (DataLab)
- **类别数组**: 最多3个类别 (`get-category-trends`)
- **关键词数组**: 最多5个关键词 (`get-keyword-trends`)
- **每日调用限制**: 1,000次/天
### 搜索 API
- **每日调用限制**: 25,000次/天
- **display**: 最多100个
- **start**: 最多1,000
## 项目结构
```
naver-api-mcp/
├── src/
│ ├── index.ts # 服务器入口
│ ├── server.ts # MCP 服务器定义
│ └── clients/
│ ├── shoppingInsightClient.ts # 购物洞察 API 客户端
│ └── searchClient.ts # 搜索 API 客户端
├── dist/ # 构建结果
├── package.json
└── README.md
```
## 许可证
ISC
## 参考资料
- [네이버 데이터랩 API 文档 > 쇼핑인사이트](https://developers.naver.com/docs/serviceapi/datalab/shopping/shopping.md)
- [네이버 검색 API 文档 > 블로그](https://developers.naver.com/docs/serviceapi/search/blog/blog.md)
- [네이버 검색 API 文档 > 지식iN](https://developers.naver.com/docs/serviceapi/search/kin/kin.md)
- [네이버 검색 API 文档 > 쇼핑](https://developers.naver.com/docs/serviceapi/search/shopping/shopping.md)
- [네이버 검색 API 文档 > 백과사전](https://developers.naver.com/docs/serviceapi/search/encyclopedia/encyclopedia.md)
- [Model Context Protocol](https://modelcontextprotocol.io)
