使用说明
NAVER Data Lab MCP服务器
该项目将NAVER Data Lab API 模型上下文协议（MCP） 作为接口提供的服务器。
功能
搜索趋势
- 提供NAVER数据实验室综合搜索词趋势API
- 按搜索词组查询趋势（最多5个组，每组最多5个搜索词）
- 支持按时间、性别、年龄和设备进行筛选
购物洞察
- 购物领域趋势查询功能（最多3个领域）
- 特定购物领域内按关键词查询趋势功能（最多3个关键词）
- 支持按时间、性别、年龄和设备进行筛选
设置
通过npm安装
npm install -g naver-datalab-mcp-server
按源代码安装
# 저장소 클론
git clone https://github.com/sonhyeonho/naver-data-lab-mcp-server.git
cd naver-data-lab-mcp-server
# 의존성 설치 및 빌드
npm install
npm run build
设置开发环境
设置环境变量
.env 创建文件并添加以下内容：
# .env.example 파일을 복사하여 .env 파일 생성
cp .env.example .env
# .env 파일을 열고 다음 내용을 수정
NAVER_CLIENT_ID=your_naver_client_id_here
NAVER_CLIENT_SECRET=your_naver_client_secret_here
运行开发服务器
# 개발 모드로 실행
npm run dev
# 빌드
npm run build
# 실행
npm start
如何使用API
查询查询趋势
{
startDate: "2024-01-01", // YYYY-MM-DD 형식
endDate: "2024-01-31", // YYYY-MM-DD 형식
timeUnit: "date", // "date" | "week" | "month"
keywordGroups: [ // 최대 5개 그룹
{
groupName: "그룹1",
keywords: ["검색어1", "검색어2"] // 그룹당 최대 5개
}
],
device: "pc", // 선택사항: "pc" | "mo" | ""
gender: "f", // 선택사항: "f" | "m" | ""
ages: ["20", "30"] // 선택사항: ["1"~"11"]
}
浏览购物洞察领域的趋势
{
startDate: "2024-01-01",
endDate: "2024-01-31",
timeUnit: "date",
category: [ // 최대 3개 분야
{
name: "패션의류",
param: ["50000000"] // 네이버 쇼핑 카테고리 코드
}
],
device: "pc", // 선택사항
gender: "f", // 선택사항
ages: ["20", "30"] // 선택사항
}
按购物洞察关键字查询趋势
{
startDate: "2024-01-01",
endDate: "2024-01-31",
timeUnit: "date",
category: "50000000", // 쇼핑 분야 코드
keyword: [ // 최대 3개 키워드
{
name: "키워드1",
param: ["검색어1", "검색어2"] // 최대 5개
}
],
device: "pc", // 선택사항
gender: "f", // 선택사항
ages: ["20", "30"] // 선택사항
}
年龄段代码
- “1”：0-12岁
- “2”：13-18岁
- “3”：19-24岁
- “4”：25-29岁
- “5”：30-34岁
- “6”：35-39岁
- “7”：40-44岁
- “8”：45-49岁
- “9”：50-54岁
- “10”：55-59岁
- “11”：60岁以上
API参考资料
MCP服务器设置
运行MCP服务器
npx -y naver-datalab-mcp-server
MCP设置示例
{
"naver-datalab": {
"command": "npx",
"args": [
"-y",
"naver-datalab-mcp-server"
],
"env": {
"NAVER_CLIENT_ID": "your_naver_client_id_here",
"NAVER_CLIENT_SECRET": "your_naver_client_secret_here"
}
}
}
系统要求
- Node.js>=18.0.0
许可证
麻省理工学院
