Naver Search MCP Server

Naver 搜索 MCP 服务

用于集成 Naver 搜索 API 和 DataLab（数据实验室）API 的 Model Context Protocol（MCP）服务。
支持网页、新闻、博客、购物洞察、搜索词趋势分析和自然语言购物类别搜索。

• 英文文档 (README-en.md)

---

快速设置（Quick Start）

请将以下设置添加到您使用的 MCP 客户端配置文件（claude_desktop_config.json、mcp.json 等）的 mcpServers 中，例如 Claude Desktop、Cursor、Claude Code、Cline 等。

说明： Kakao PlayMCP 集成服务已停止支持。请在本地环境中直接设置 API 密钥后使用。

1. NAVER API HUB（推荐 / 新申请）

使用 Naver Cloud Platform（NCP）的 NAVER API HUB 密钥时：

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NCP_APIGW_API_KEY_ID": "your_client_id",
        "NCP_APIGW_API_KEY": "your_client_secret"
      }
    }
  }
}

2. Naver 开发者中心（仅限现有密钥持有者）

使用现有 Naver 开发者中心（openapi.naver.com）密钥时（支持至 2027-06-30）：

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. OpenClaw（ClawHub）

使用 OpenClaw 时，可以通过 ClawHub 技能立即安装：

openclaw skills install naver-search-mcp

注意： 必须在 OpenClaw 环境中设置 NAVER API HUB 密钥对（NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY）或开发者中心密钥对（NAVER_CLIENT_ID / NAVER_CLIENT_SECRET）中的一对。

---

API 密钥申请说明

调用平台会根据您使用的环境变量密钥对自动确定。（请仅设置一对）

平台	环境变量	备注
NAVER API HUB（推荐）	NCP_APIGW_API_KEY_ID NCP_APIGW_API_KEY	• 登录 Naver Cloud Platform 控制台 • Menu > All Services > Application Services > NAVER API HUB > 注册应用后，查看“认证信息”
Naver 开发者中心（现有）	NAVER_CLIENT_ID NAVER_CLIENT_SECRET	• 自 2026-07-31 起停止新密钥申请 • 已发放的密钥可正常使用至 2027-06-30

---

提供的工具（Tools）

1. 类别搜索

• find_category：即使不知道类别编号，也可以通过自然语言搜索查询购物洞察所需的类别 ID。

2. 搜索工具（Search）

• search_webkr：搜索网页文档
• search_news：搜索新闻
• search_blog：搜索博客
• search_cafearticle：搜索论坛帖子
• search_image：搜索图片
• search_kin：搜索知识 iN
• search_encyc：搜索百科词条
• search_local：搜索本地地点

3. DataLab 趋势分析（DataLab）

日期参数支持 "today" 关键词（例如：endDate: "today"）。

• datalab_search：分析搜索词趋势
• datalab_shopping_category：按购物类别查看点击趋势
• datalab_shopping_by_device：按设备（PC/移动端）查看购物趋势
• datalab_shopping_by_gender：按性别查看购物趋势
• datalab_shopping_by_age：按年龄段查看购物趋势
• datalab_shopping_keywords：查看购物关键词趋势
• datalab_shopping_keyword_by_device：按设备查看关键词趋势
• datalab_shopping_keyword_by_gender：按性别查看关键词趋势
• datalab_shopping_keyword_by_age：按年龄段查看关键词趋势

---

许可证

MIT License