Naver 搜索 MCP 服务器

该 MCP（多平台通信协议）服务器提供对 Naver 搜索 API 的访问，允许 AI 代理在 Naver 上搜索各种类型的内容。

概述

搜索博客、新闻、书籍、图片、购物商品等
支持分页的多个搜索类别
针对 LLM 使用进行了优化的结构化文本响应
检查成人内容
转换键盘输入错误（勘误表）

设置

先决条件

Python 3.12+
Naver 开发者 API 凭证
- 您可以通过在Naver Developers门户上注册来获取这些凭证。
- 您也可以查看我的博客Naver Search API MCP Server 。

安装

克隆存储库：

git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search

紫外线安装

curl -LsSf https://astral.sh/uv/install.sh | sh

创建虚拟环境并安装依赖项：

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt

使用您的 Naver API 凭据创建一个.env文件：

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

使用 Docker

构建 Docker 镜像：

docker build -t py-mcp-naver-search .

运行容器：

docker run py-mcp-naver-search

使用本地

运行服务器：

mcp run server.py

配置 MCP 设置

将服务器配置添加到您的 MCP 设置文件：

克劳德桌面应用程序

要通过Smithery自动安装：

npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude

要手动安装，请打开~/Library/Application Support/Claude/claude_desktop_config.json

将其添加到mcpServers对象：

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

游标 IDE

打开~/.cursor/mcp.json

将其添加到mcpServers对象：

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

对于 Docker

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-naver-search"
      ]
    }
  }
}

使用客户端

该存储库包含用于测试的客户端脚本：

# Basic search
uv run client.py blog "Python programming" display=5 page=1

# News search with sorting
uv run client.py news "AI" display=10 page=1 sort=date

# Image search with filtering
uv run client.py image "cat" display=10 filter=large

# Check for adult content
uv run client.py adult "your query"

# Errata correction
uv run client.py errata "spdlqj"

可用的搜索类别

服务器支持以下搜索类别：

blog - 博客文章
news - 新闻文章
book - 书籍
adult - 成人内容检查
encyc百科全书条目
cafe_article - 咖啡馆文章
kin - 问答知识
local - 本地商业信息
errata - 键盘输入错误修正
shop - 购物商品
doc - 学术论文和文件
image - 图片
webkr ——Web 文档

API 参考

工具

搜索博客

search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索博客。

搜索新闻

search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索新闻。

搜索图书

search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索书籍信息。

检查成人查询

check_adult_query(query: str) -> str

确定输入查询是否是成人搜索词。

搜索百科全书

search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索百科全书信息。

搜索咖啡馆文章

search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索咖啡馆文章。

搜索知识

search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索知识问答。

搜索本地

search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str

使用给定的关键字搜索本地商业信息。

更正勘误表

correct_errata(query: str) -> str

转换韩语/英语键盘输入错误。

搜索商店

search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

使用给定的关键字在 Naver 上搜索购物产品信息。

搜索文档

search_doc(query: str, display: int = 10, page: int = 1) -> str

使用给定的关键字搜索学术论文、报告等。

搜索图片

search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str

使用给定的关键字搜索图像。

搜索网络文档

search_webkr(query: str, display: int = 10, page: int = 1) -> str

使用给定的关键字搜索网络文档。

资源

可用的搜索类别

GET http://localhost:8000/available-search-categories

返回此 MCP 服务器上可用的 Naver 搜索类别列表。

响应格式

所有工具都以结构化文本格式返回响应，并针对 LLM 处理进行了优化：

Naver Blog search results (total 12,345 of 1~10):

### Result 1
Title(title): Sample Blog Post
Link(link): https://blog.example.com/post1
Description(description): This is a sample blog post about...
Blogger name(bloggername): John Doe
Blogger link(bloggerlink): https://blog.example.com
Post date(postdate): 20250429

### Result 2
...

致谢

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

Integrations