Naver Search MCP Server

Naver搜索MCP服务器


 

MCP服务器，用于Naver Search API和DataLab API集成，实现各种Naver服务的全面搜索和数据趋势分析。

可在ClawHub上获取OpenClaw

您可以从ClawHub安装此MCP服务器作为OpenClaw技能：

openclaw skills install naver-search-mcp

ClawHub技能在内部使用已发布的npm包，并要求 NAVER_CLIENT_ID 和 NAVER_CLIENT_SECRET 在您的OpenClaw环境中。

快速入门：在没有API密钥的情况下使用

您可以在没有API密钥的情况下通过 Kakao PlayMCP。只需访问链接并立即开始使用即可！

工具详细信息

可用工具：

🆕 类别搜索

• 查找类别：类别搜索工具，因此您不再需要手动检查URL中的类别号以进行趋势和购物洞察搜索。请用自然语言描述该类别。

搜索工具

• search_webkr：搜索Naver网络文档
• 搜索_新闻：搜索Naver新闻
• search_blog：搜索Naver博客
• 搜索安全文章：搜索Naver咖啡馆文章
• search_shop：搜索Naver购物
• 搜索图像：搜索Naver图片
• search_kin：搜索Naver知识iN
• 搜索_书籍：搜索Naver书籍
• search_encyc：搜索Naver百科全书
• 搜索_学术：搜索Naver学术论文
• search_local：搜索Naver当地地点

DataLab工具

• datalab_search：分析搜索词趋势
• 数据标签_购物_类别：分析购物类别趋势
• datalab_shopping_by_device：按设备分析购物趋势
• 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：按年龄组分析购物关键词趋势

获取API密钥

1. 访问 Naver开发者 并使用您的Naver帐户登录
2. 点击“应用注册”按钮
3. 填写申请信息：

- 应用程序名称：输入任何名称（例如“Naver Search MCP”） - 用法：Select“Search”（搜索）

1. 在API设置部分中，选中以下所有API：

- 搜索 (검색) - 博客、新闻、书籍、咖啡馆文章、网络、图片、亲属、百科全书、学术和本地搜索都需要 - DataLab-搜索趋势 （数据实验室-搜索趋势）-Required for search term trend analysis - DataLab-购物洞察 （数据实验室-购物洞察）-Required for shopping trend analysis

1. 点击“注册”完成注册
2. 注册后，您将看到您的 客户端ID 和 客户端密钥 在应用程序详细信息页面上
3. 在下面的配置中使用这些凭据

安装

方法1:NPX安装（推荐）

使用此MCP服务器的最可靠方法是通过NPX。有关详细的包装信息，请参阅 .

Claude桌面配置

添加到Claude Desktop配置文件(%APPDATA%\Claude\claude_desktop_config.json 在Windows上， ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS/Linux上）：

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

Claude代码配置

添加到您的克劳德代码设置中：

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

方法2:OpenClaw的ClawHub安装

此MCP服务器也可以通过ClawHub技能包装器从OpenClaw使用。安装时使用：

openclaw skills install naver-search-mcp

ClawHub技能在内部使用相同的已发布npm包：

npx -y @isnow890/naver-search-mcp

确保 NAVER_CLIENT_ID 和 NAVER_CLIENT_SECRET 在使用该技能之前，请在您的OpenClaw环境中进行配置。

方法3：就地安装

对于本地开发或自定义修改：

步骤1：下载并构建源代码

使用Git进行克隆

git clone https://github.com/isnow890/naver-search-mcp.git
cd naver-search-mcp
npm install
npm run build

或下载ZIP文件

1. 从下载最新版本
2. 将ZIP文件解压缩到所需位置
3. 导航到终端中提取的文件夹：

cd /path/to/naver-search-mcp
npm install
npm run build

⚠️ 重要：你必须跑 npm run build 安装后生成 dist 包含已编译JavaScript文件的文件夹。

步骤2:克劳德桌面配置

构建后，您将需要以下信息：

• NAVER_CLIENT_ID：Naver开发商的客户ID
• 导航客户端密码：Naver开发商的客户机密
• 安装路径：下载文件夹的绝对路径

Windows配置

添加到Claude Desktop配置文件(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "naver-search": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "C:\\path\\to\\naver-search-mcp\\dist\\src\\index.js"
      ],
      "cwd": "C:\\path\\to\\naver-search-mcp",
      "env": {
        "NAVER_CLIENT_ID": "your-naver-client-id",
        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
      }
    }
  }
}

macOS/Linux配置

添加到Claude Desktop配置文件(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "naver-search": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/naver-search-mcp/dist/src/index.js"],
      "cwd": "/path/to/naver-search-mcp",
      "env": {
        "NAVER_CLIENT_ID": "your-naver-client-id",
        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
      }
    }
  }
}

路径配置重要注意事项

⚠️ 重要：您必须将上述配置中的以下路径更改为实际安装路径：

• 视窗：更改 C:\\path\\to\\naver-search-mcp 到您实际下载的文件夹路径
• macOS/Linux：更改 /path/to/naver-search-mcp 到您实际下载的文件夹路径
• 生成路径：确保路径指向 dist/src/index.js （不只是 index.js)

找到你的路：

# Check current location
pwd

# Absolute path examples
# Windows: C:\Users\username\Downloads\naver-search-mcp
# macOS: /Users/username/Downloads/naver-search-mcp
# Linux: /home/username/Downloads/naver-search-mcp

步骤3：重新启动克劳德桌面

完成配置后，完全关闭并重新启动Claude Desktop以激活Naver Search MCP服务器。

先决条件

• Naver Developers API密钥（客户端ID和密钥）
• Node.js 18或更高版本
• NPM 8或更高

许可证

MIT许可证

______________________________________________________________________

版本历史

1.0.48 (2026-05-12)

• 固定的 find_category MCP服务器启动时的数据加载 npx 来自其他工作目录
• 在退回到本地开发路径之前，类别数据现在已相对于已安装的软件包进行了解析

1.0.47 (2025-01-03)

• 添加了“today”关键字支持 对于所有DataLab日期参数，无需调用单独的时间工具
• 修复了服务器终止问题 -当客户端断开连接时，MCP服务器现在可以正确退出
• 添加了优雅的关机处理程序 用于信号情报、信号战和运输近距离事件
• 已删除get_current_korean_time工具 -新增“today”关键字功能
• 已拆下内存监控模块 -已解决setInterval阻塞进程退出
• 特别感谢@gloomyrobot 用于报告服务器终止问题

1.0.45 (2025-09-28)

• 解决了托管MCP安装的平台兼容性问题
• 将类别搜索中的Excel导出替换为JSON，以提高兼容性
• 已恢复 search_webkr 韩国网络搜索工具
• 改进了托管平台安装兼容性

1.0.44 (2025-08-31)

• 添加了 get_current_korean_time 韩国标准时间基本背景的工具
• 在现有的时间查询工具描述中引用时间工具
• 改进了对具有时间上下文的“今天”、“现在”和“当前”搜索的处理
• 扩展了多种格式的韩语日期和时间格式输出

1.0.40 (2025-08-21)

• 添加了 find_category 该工具具有模糊匹配功能，因此您不再需要在URL中手动检查类别号
• 使用Zod模式增强参数验证
• 改进了类别搜索工作流程
• 实施了基于级别的类别排名系统，优先考虑顶级类别

1.0.30 (2025-08-04)

• MCP SDK升级到1.17.1
• 修复了托管MCP平台规范更改的兼容性问题
• 添加了全面的DataLab购物类别代码文档

1.0.2 (2025-04-26)

• README更新：咖啡馆文章搜索工具和版本历史部分得到改进

1.0.1 (2025-04-26)

• 添加了咖啡馆文章搜索功能
• 购物类别信息已添加到zod
• 源代码重构

1.0.0 (2025-04-08)

• 初始版本