Enables access to Naver Search APIs, allowing search across blogs, news, books, images, shopping items, encyclopedia entries, cafe articles, Knowledge iN Q&A, local business information, academic papers, and web documents, with support for pagination, sorting, and filtering.
Provides access to blog content via reference to a blog post about the Naver Search API MCP Server implementation.
This MCP (Multi-platform Communication Protocol) server provides access to Naver Search APIs, allowing AI agents to search for various types of content on Naver.
Search for blogs, news, books, images, shopping items, and more
Multiple search categories with pagination support
Structured text responses optimized for LLM consumption
Check for adult content
Convert keyboard input errors (errata)
Related MCP server: KiMCP
Python 3.12+
Naver Developer API credentials
You can obtain these credentials by signing up at the Naver Developers portal.
And You can check my blog Naver Search API MCP Server, too.
Clone the repository:
git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-searchuv installation
curl -LsSf https://astral.sh/uv/install.sh | shCreate a virtual environment and install dependencies:
uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txtCreate a .env file with your Naver API credentials:
cp env.example .env
vi .env
NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_hereBuild the Docker image:
docker build -t py-mcp-naver-search .Run the container:
docker run py-mcp-naver-searchRun the server:
mcp run server.pyRun the MCP Inspector
mcp dev server.pyAdd the server configuration to your MCP settings file:
To install automatically via Smithery:
npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claudeTo install manually
open ~/Library/Application Support/Claude/claude_desktop_config.json
Add this to the mcpServers object:
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}open ~/.cursor/mcp.json
Add this to the mcpServers object:
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-naver-search"
]
}
}
}The repository includes a client script for testing:
# 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"The server supports the following search categories:
blog - Blog posts
news - News articles
book - Books
adult - Adult content check
encyc - Encyclopedia entries
cafe_article - Cafe articles
kin - Knowledge iN Q&A
local - Local business information
errata - Keyboard input error correction
shop - Shopping items
doc - Academic papers and documents
image - Images
webkr - Web documents
search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for blogs on Naver using the given keyword.
search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for news on Naver using the given keyword.
search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for book information on Naver using the given keyword.
check_adult_query(query: str) -> strDetermines if the input query is an adult search term.
search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for encyclopedia information on Naver using the given keyword.
search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for cafe articles on Naver using the given keyword.
search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for Knowledge iN Q&A on Naver using the given keyword.
search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> strSearches for local business information using the given keyword.
correct_errata(query: str) -> strConverts Korean/English keyboard input errors.
search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> strSearches for shopping product information on Naver using the given keyword.
search_doc(query: str, display: int = 10, page: int = 1) -> strSearches for academic papers, reports, etc. using the given keyword.
search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> strSearches for images using the given keyword.
search_webkr(query: str, display: int = 10, page: int = 1) -> strSearches for web documents using the given keyword.
GET naver://available-search-categoriesReturns a list of Naver search categories available on this MCP server.
All tools return responses in structured text format, optimized for LLM processing:
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
...This project is licensed under the MIT License - see the LICENSE file for details.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
The best web search for your AI Agent
Web search, page extraction and structured commerce, social and business data for AI agents
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jikime/py-mcp-naver-search'
If you have feedback or need assistance with the MCP directory API, please join our Discord server