Naver Search MCP Server

by isnow890
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Optional containerization platform for deploying the MCP server in an isolated environment.

  • Enables comprehensive search across various Naver services (web, news, blogs, shopping, images, KnowledgeiN, books, encyclopedia, academic papers, local places) and data trend analysis through Naver Search API and DataLab API.

  • Required runtime environment for the MCP server, version 18 or higher needed for server operation.

Naver 搜索 MCP 服务器

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

先决条件

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

获取 API 密钥

  1. 访问Naver 开发者
  2. 点击“注册申请”
  3. 输入应用程序名称并选择以下所有 API:
    • 搜索(博客、新闻、书籍搜索等)
    • DataLab(搜索趋势)
    • DataLab(购物洞察)
  4. 将获取到的Client ID和Client Secret设置为环境变量

安装

选项 1:通过 Smithery 快速安装(推荐)

要通过 Smithery 自动安装 Naver Search MCP 服务器,请根据您的 AI 客户端使用以下命令之一:

对于 Claude 桌面:

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

对于光标:

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

对于风帆冲浪:

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

对于克莱恩来说:

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

安装程序将提示您:

  • NAVER_客户端ID
  • NAVER_CLIENT_SECRET

选项 2:手动安装

环境变量

# Windows set NAVER_CLIENT_ID=your_client_id set NAVER_CLIENT_SECRET=your_client_secret # Linux/Mac export NAVER_CLIENT_ID=your_client_id export NAVER_CLIENT_SECRET=your_client_secret

使用 NPX 运行

npx @modelcontextprotocol/server-naver-search

使用 Docker 运行

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

光标桌面配置

添加到claude_desktop_config.json

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

对于 Docker:

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

工具详细信息

搜索工具

每个搜索工具都接受以下参数:

  • query :搜索词(必填)
  • display :显示的结果数(默认值:10)
  • start :起始位置(默认值:1)
  • sort :排序方法(sim:相似度,date:日期)

可用的搜索工具:

  • search_webkr :搜索 Naver 网页文档
  • search_news :搜索 Naver 新闻
  • search_blog :搜索 Naver 博客
  • search_shop :搜索 Naver 购物
  • search_image :搜索 Naver 图片
  • search_kin : 搜索 Naver KnowledgeiN
  • search_book :搜索 Naver 图书
  • search_encyc :搜索 Naver 百科全书
  • search_academic :搜索 Naver 学术论文
  • search_local :搜索 Naver 本地地点

DataLab 工具

  • datalab_search
    • 分析搜索词趋势
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(日/周/月)
      • keywordGroups :关键字组数组
        • groupName :组名称
        • keywords :关键词数组
  • datalab_shopping_category
    • 购物类别趋势分析
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码和名称的数组。
  • datalab_shopping_by_device
    • 特定设备的购物趋势分析
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • device :设备类型(pc:PC,mo:移动设备)
  • datalab_shopping_by_gender
    • 性别购物趋势分析
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • gender :性别(f:女性,m:男性)
  • datalab_shopping_by_age
    • 按年龄段分析购物趋势
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • ages :年龄组数组(例如 ["10", "20", "30"])
  • datalab_shopping_keywords
    • 购物关键词趋势分析
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • keyword :关键字和名称的数组
  • datalab_shopping_keyword_by_device
    • 按设备分析购物关键词趋势
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • keyword :搜索关键字
      • device :设备类型(pc:PC,mo:移动设备)
  • datalab_shopping_keyword_by_gender
    • 购物关键词性别趋势分析
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • keyword :搜索关键字
      • gender :性别(f:女性,m:男性)
  • datalab_shopping_keyword_by_age
    • 按年龄分析购物关键词趋势
    • 参数:
      • startDate :分析开始日期(YYYY-MM-DD)
      • endDate :分析结束日期(YYYY-MM-DD)
      • timeUnit :分析时间单位(date:每日,week:每周,month:每月)
      • category :购物类别代码
      • keyword :搜索关键字
      • ages :年龄组数组(例如 ["10", "20", "30"])

建造

Docker 构建:

docker build -t mcp/naver-search .

执照

MIT 许可证

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

MCP 服务器可通过 Naver 的搜索 API 搜索各种内容类型(新闻、博客、购物、图像等)。

  1. Prerequisites
    1. Getting API Keys
      1. Installation
        1. Option 1: Quick Install via Smithery (Recommended)
        2. Option 2: Manual Installation
      2. Cursor Desktop Configuration
        1. Tool Details
          1. Search Tools
          2. DataLab Tools
        2. Build
          1. License
            ID: kpv7kdyboo