Naver Data MCP Server

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参考资料

• NAVER数据实验室搜索词趋势API文档
• NAVER数据实验室购物洞察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

许可证

麻省理工学院