导航搜索MCP

Name: 导航搜索MCP
Author: isnow890

作者：isnow89046 星标更新：2025-10-19

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Naver Search MCP Server

用于集成 Naver 搜索 API 和 DataLab API 的 MCP 服务器，支持在各种 Naver 服务中进行综合搜索及数据分析。

版本历史

1.0.45 (2025-09-28)

解决了与 Smithery 兼容性问题，现在可以通过 Smithery 使用最新功能
将类别搜索中的 Excel 导出替换为 JSON，以提高兼容性
恢复了 search_webkr 工具，用于韩文网络搜索
完全兼容 Smithery 平台安装

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
解决了与 Smithery 规范变更的兼容性问题
添加了全面的数据实验室购物类别代码文档

1.0.2 (2025-04-26)

更新了 README：改进了咖啡厅文章搜索工具和版本历史部分

1.0.1 (2025-04-26)

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

1.0.0 (2025-04-08)

初始发布

预备条件

Naver 开发者 API 密钥（客户端 ID 和密钥）
Node.js 18 或更高版本
NPM 8 或更高版本
Docker（可选，用于容器部署）

获取 API 密钥

访问 Naver 开发者
点击“注册应用”
输入应用名称并选择以下所有 API：
- 搜索（博客、新闻、书籍搜索等）
- DataLab（搜索趋势）
- DataLab（购物洞察）
将获取到的客户端 ID 和客户端密钥设置为环境变量

工具详情

可用工具：

🕐 时间与上下文工具

get_current_korean_time：获取当前韩国标准时间（KST）以及详细的日期和时间信息。当需要在韩国进行“今天”、“现在”或“当前”等时间上下文的搜索或分析时使用此工具。

🆕 类别搜索

find_category：类别搜索工具，无需手动检查 URL 中的类别编号即可进行趋势和购物洞察搜索。只需用自然语言描述类别即可。

搜索工具

search_webkr：搜索 Naver 网页文档
search_news：搜索 Naver 新闻
search_blog：搜索 Naver 博客
search_cafearticle：搜索 Naver 咖啡厅文章
search_shop：搜索 Naver 购物
search_image：搜索 Naver 图片
search_kin：搜索 Naver 知识iN
search_book：搜索 Naver 书籍
search_encyc：搜索 Naver 百科全书
search_academic：搜索 Naver 学术论文
search_local：搜索 Naver 地方信息

DataLab 工具

datalab_search：分析搜索词趋势
datalab_shopping_category：分析购物类别趋势
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：按年龄组分析购物关键词趋势

完整类别列表：

要获取完整的类别代码列表，可以从 Naver 购物合作伙伴中心下载，或者通过浏览 Naver 购物类别来提取它们。

🎯 商业案例与场景

🛍️ 电子商务市场研究

// 时尚趋势发现
find_category("fashion") → 查看顶级时尚类别及其代码
datalab_shopping_category → 分析季节性时尚趋势
datalab_shopping_age → 确定时尚目标人群
datalab_shopping_keywords → 对比“连衣裙”、“夹克”和“外套”的表现

📱 数字营销策略

// 美妆行业分析
find_category("cosmetics") → 查找美妆类别
datalab_shopping_gender → 95%女性 vs 5%男性购物者
datalab_shopping_device → 移动端主导美妆购物
datalab_shopping_keywords → “口红” vs “唇彩”的关键词表现

🏢 商业智能与竞争分析

// 科技产品洞察
find_category("smartphone") → 查看电子类别
datalab_shopping_category → 跟踪 iPhone vs Galaxy 趋势
datalab_shopping_age → 主要智能手机购买者为20-30岁
datalab_shopping_device → PC vs 移动端购物行为

📊 季节性商业规划

// 节假日购物分析
find_category("gift") → 礼品类别
datalab_shopping_category → 黑色星期五、圣诞节趋势
datalab_shopping_keywords → “母亲节礼物” vs “生日礼物”
datalab_shopping_age → 基于年龄的礼品购买模式

🎯 客户画像开发

// 健身市场分析
find_category("exercise") → 运动/健身类别
datalab_shopping_gender → 男性 vs 女性健身支出
datalab_shopping_age → 主要健身人群（20-40岁）
datalab_shopping_keywords → “家庭锻炼” vs “健身房”趋势分析

📈 高级分析场景

市场进入策略

类别发现：使用 find_category 探索市场细分
趋势分析：识别增长 vs 下降的类别
人口统计定位：年龄/性别分析以确定客户定位
竞争情报：关键词表现对比
设备策略：移动端 vs PC 购物优化

产品上市计划

市场验证：类别增长趋势和季节性
目标客户：人口统计分析以确定产品定位
营销渠道：设备偏好以制定广告策略
竞争格局：关键词竞争和机会
定价策略：类别表现和价格相关性

绩效监控

类别健康：监控产品类别趋势
关键词跟踪：跟踪品牌和产品关键词表现
人口统计变化：监控客户人口统计的变化
季节性模式：规划库存和营销活动
竞争基准：与类别平均值比较性能

快速参考：热门类别代码

类别	代码	韩文
时尚/服装	50000000	패션의류
化妆品/美容	50000002	화장품/미용
数码/电子产品	50000003	디지털/가전
运动/休闲	50000004	스포츠/레저
食品/饮料	50000008	식품/음료
健康/医疗用品	50000009	건강/의료용품

💡 提示：使用 find_category 进行模糊搜索，如“美容”、“时尚”、“电子产品”，轻松找到类别。

安装

方法 1：NPX 安装（推荐）

使用 NPX 是最可靠的方式。有关详细包信息，请参阅 NPM 包页面。

Claude Desktop 配置

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

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

Cursor AI 配置

添加到 mcp.json：

{
  "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：Smithery 安装（替代方案 - 已知问题）

⚠️ 重要通知：由于 Smithery WebSocket 中继基础设施的问题，Smithery 安装可能会遇到连接超时和冻结。这是平台限制而非此 MCP 服务器的错误。为了稳定使用，我们强烈建议使用方法 1（NPX 安装）。

Smithery 已知问题：

服务器初始化可能挂起或超时
可能出现 Error -32001: 请求超时
WebSocket 连接可能在握手后立即断开
服务器可能在处理请求前意外退出

如果仍然想尝试 Smithery：

对于 Claude Desktop：

npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude

对于其他 AI 客户端：

# Cursor
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor

# Windsurf
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf

# Cline
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline

如果在 Smithery 上遇到超时，请切换回方法 1（NPX）以获得稳定的体验。

方法 3：本地安装

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

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

使用 Git 克隆

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

或下载 ZIP 文件

从 GitHub Releases 下载最新版本
将 ZIP 文件解压到所需位置
在终端中导航到解压的文件夹：

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

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

步骤 2：Claude Desktop 配置

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

NAVER_CLIENT_ID：来自 Naver 开发者的客户端 ID
NAVER_CLIENT_SECRET：来自 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"
      }
    }
  }
}

路径配置注意事项

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

Windows：将 C:\\path\\to\\naver-search-mcp 更改为您的实际下载文件夹路径
macOS/Linux：将 /path/to/naver-search-mcp 更改为您的实际下载文件夹路径
构建路径：确保路径指向 dist/src/index.js（而不是仅仅 index.js）

查找您的路径：

# 检查当前位置
pwd

# 绝对路径示例
# 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

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

替代安装方法

方法 4：Docker 安装

用于容器化部署：

docker run -i --rm \
  -e NAVER_CLIENT_ID=your_client_id \
  -e NAVER_CLIENT_SECRET=your_client_secret \
  mcp/naver-search

Docker 配置用于 Claude Desktop：

{
  "mcpServers": {
    "naver-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NAVER_CLIENT_ID=your_client_id",
        "-e",
        "NAVER_CLIENT_SECRET=your_client_secret",
        "mcp/naver-search"
      ]
    }
  }
}

构建

Docker 构建：

docker build -t mcp/naver-search .

许可证

MIT 许可证