AI导哈

购物趋势分析API

整合Naver购物洞察和搜索API，提供多维度的购物趋势分析和搜索功能。

  • by dataartai
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dataartai/naver-api-mcp

使用说明

NAVER API MCP服务器

集成NAVER购物洞察API和搜索API提供的模型上下文协议（MCP）服务器。

功能

购物洞察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：搜索百科全书

安装

从源代码安装

# 저장소 클론
git clone https://github.com/dataartai/naver-api-mcp.git
cd naver-api-mcp

# 의존성 설치
npm install

# 빌드
npm run build

设置

  1. NAVER开发者中心（https://developers.naver.com）注册应用程序，并获得客户端ID和秘密。

    • 购物洞察API：DataLab>申请使用购物洞察API
    • 搜索API：申请使用搜索API

  2. 设置环境变量：

方法1： .env 使用文件（本地开发）

NAVER_CLIENT_ID=your-client-id
NAVER_CLIENT_SECRET=your-client-secret

方法2:直接在MCP设置文件中设置

{
  "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"
      }
    }
  }
}

使用方法

直接运行

npm start

Claude桌面设置

要在Claude Desktop中使用，请将其添加到以下设置文件：

视窗: %APPDATA%\Claude\claude_desktop_config.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：仅限NAVER Pay联动商品）-选择
  • 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)
  • 每日呼叫限制：每天1000次

搜索API

  • 每日呼叫限制：每天25000次
  • 显示：最多100个
  • 开始：最多1000

项目结构

naver-api-mcp/
├── src/
│   ├── index.ts              # 서버 진입점
│   ├── server.ts             # MCP 서버 정의
│   └── clients/
│       ├── shoppingInsightClient.ts  # 쇼핑인사이트 API 클라이언트
│       └── searchClient.ts            # 검색 API 클라이언트
├── dist/                     # 빌드 결과물
├── package.json
└── README.md

许可证

ISC

参考资料

相关 MCP