JinDaGe - Naver Search MCP Details

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 文件。

Naver Search