Naver搜索MCP服务器
](https://smithery.ai/server/@jikime/py-mcp-naver-search) 
此MCP（多平台通信协议）服务器提供对Naver搜索API的访问，允许AI代理在Naver上搜索各种类型的内容。
概述
- 搜索博客、新闻、书籍、图片、购物项目等
- 支持分页的多个搜索类别
- 针对LLM消费优化的结构化文本响应
- 检查成人内容
- 转换键盘输入错误（勘误表）
目录
设置
先决条件
- Python 3.12+
- Naver开发人员API证书
- 您可以通过在以下网址注册来获得这些凭据 Naver开发者 门户。 - 你可以查看我的博客 导航搜索API MCP服务器也是。
安装
- 克隆存储库：
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- 创建一个
.env使用Naver API凭证提交文件：
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 dev server.py配置MCP设置
将服务器配置添加到MCP设置文件中：
Claude桌面应用程序
- 通过自动安装 史密瑟里:
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上搜索咖啡馆文章。
搜索知识iN
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使用给定的关键字搜索图像。
搜索Web文档
search_webkr(query: str, display: int = 10, page: int = 1) -> str使用给定的关键字搜索web文档。
资源
可用搜索类别
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许可证获得许可-有关详细信息，请参阅许可证文件。