Naver智能搜索
提供了对Naver搜索API的访问，允许AI代理在多个类别（博客、新闻、书籍、图像、购物商品等）中进行搜索，并以针对大型语言模型优化的结构化响应形式返回结果。
服务介绍
Naver Search MCP 服务器
此 MCP（多平台通信协议）服务器提供了访问 Naver 搜索 API 的功能，允许 AI 代理在 Naver 上搜索各种类型的内容。
概览
- 搜索博客、新闻、书籍、图片、购物商品等
- 支持分页的多种搜索类别
- 为 LLM 消费优化的结构化文本响应
- 检查成人内容
- 转换键盘输入错误（勘误）
目录
设置
先决条件
- Python 3.12+
- Naver 开发者 API 凭证
- 您可以通过注册 Naver 开发者门户来获取这些凭证。
- 您也可以查看我的博客 Naver Search API MCP 服务器。
安装
-
克隆仓库：
bash
git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search -
安装 uv：
bash
curl -LsSf https://astral.sh/uv/install.sh | sh -
创建虚拟环境并安装依赖项：
bash
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 镜像：
bash
docker build -t py-mcp-naver-search . -
运行容器：
bash
docker run py-mcp-naver-search
本地运行
-
运行服务器：
bash
mcp run server.py -
运行 MCP Inspector
bash
mcp dev server.py
配置 MCP 设置
将服务器配置添加到您的 MCP 设置文件中：
Claude 桌面应用程序
- 通过 Smithery 自动安装：
bash
npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude
- 手动安装
打开~/Library/Application Support/Claude/claude_desktop_config.json
将以下内容添加到 mcpServers 对象中：
json
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}
Cursor IDE
打开 ~/.cursor/mcp.json
将以下内容添加到 mcpServers 对象中：
json
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}
对于 Docker
json
{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-naver-search"
]
}
}
}
使用客户端
仓库包含一个用于测试的客户端脚本：
bash
基本搜索
uv run client.py blog "Python programming" display=5 page=1
新闻搜索并排序
uv run client.py news "AI" display=10 page=1 sort=date
图片搜索并过滤
uv run client.py image "cat" display=10 filter=large
检查成人内容
uv run client.py adult "your query"
勘误校正
uv run client.py errata "spdlqj"
可用的搜索类别
服务器支持以下搜索类别：
blog- 博客文章news- 新闻文章book- 书籍adult- 成人内容检查encyc- 百科条目cafe_article- 咖啡馆文章7.kin- 知识问答local- 本地商业信息errata- 键盘输入错误校正shop- 购物商品doc- 学术论文和文档image- 图片webkr- 网页文档
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 naver://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文件。
