返回 MCP 目录
public公开dns本地运行

Naver Search

Naver搜索MCP服务器是一个多平台通信协议服务,提供对Naver搜索API的访问,支持博客、新闻、图书、图片等多种内容的搜索,并优化了结构化文本响应以供AI代理使用。

article

README

🚀 知识整合工具

这是一个借助 Naver 搜索 API 构建的知识整合工具,遵循 MCP 协议。该工具具备多种搜索功能,涵盖博客、新闻、书籍等多个领域,能为用户提供丰富的信息检索服务。

🚀 快速开始

此知识整合工具使用 Naver 搜索 API 构建,支持多种搜索功能。在使用前,你需要完成依赖安装和环境变量配置。

✨ 主要特性

  • 支持多种搜索功能,包括博客、新闻、书籍、成人内容检查、百科全书、咖啡馆文章、知识问答、本地信息、错误校正、购物、文档和图片搜索。
  • 以结构化文本形式返回结果,方便大语言模型处理。

📦 安装指南

安装依赖

需要安装以下 Python 包:

  • requests:用于 HTTP 请求。
  • beautifulsoup4:用于 HTML 解析。
  • lxml:用于 XML 处理。

安装命令如下:

pip install requests beautifulsoup4 lxml

配置环境变量

设置 Naver 开发者访问令牌:

export NAVER_API_KEY="your_api_key_here"

💻 使用示例

基础用法

博客搜索

search_blog(query, display=10, page=1, sort="sim")
  • query:搜索关键词。
  • display:每页显示结果数(默认 10)。
  • page:请求的第几页。
  • sort:排序方式,可选值为 "sim"(相似度排序,默认)、"date"(时间排序)。

新闻搜索

search_news(query, display=10, page=1, sort="sim")

功能与博客搜索类似,用于新闻文章检索。

图书搜索

search_book(query, display=10, page=1, sort="sim")

用于查找图书信息。

成人内容检查

check_adult_query(query)

判断查询关键词是否涉及成人内容。

高级用法

错误校正

correct_errata(query)

修正韩/英文输入错误。

📚 详细文档

API 文档

可用搜索类别

GET naver://available-search-categories

返回服务器支持的所有搜索分类列表。

结果格式

所有工具均以结构化文本形式返回,便于大语言模型处理:

Naver 博客搜索结果(总计 12,345 条,显示 1~10):

### 结果 1
标题(title): 示例博客文章
链接(link): https://blog.example.com/post1
描述(description): 这是一篇关于示例的博客文章...
博主名称(bloggername): 张三
博主链接(bloggerlink): https://blog.example.com
发布日期(postdate): 20250429

### 结果 2
...

📄 许可证

本项目遵循 MIT 许可证,详情请见 LICENSE 文件。

🔗 相关资源

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端