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.
Naver Search MCP Server
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.
Overview
- 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)
Table of Contents
Setup
Prerequisites
- 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.
Installation
- Clone the repository:
- uv installation
- Create a virtual environment and install dependencies:
- Create a
.env
file with your Naver API credentials:
Using Docker
- Build the Docker image:
- Run the container:
Using Local
- Run the server:
- Run the MCP Inspector
Configure MCP Settings
Add the server configuration to your MCP settings file:
Claude desktop app
- To install automatically via Smithery:
- To install manually
open
~/Library/Application Support/Claude/claude_desktop_config.json
Add this to the mcpServers
object:
Cursor IDE
open ~/.cursor/mcp.json
Add this to the mcpServers
object:
for Docker
Using the Client
The repository includes a client script for testing:
Available Search Categories
The server supports the following search categories:
blog
- Blog postsnews
- News articlesbook
- Booksadult
- Adult content checkencyc
- Encyclopedia entriescafe_article
- Cafe articleskin
- Knowledge iN Q&Alocal
- Local business informationerrata
- Keyboard input error correctionshop
- Shopping itemsdoc
- Academic papers and documentsimage
- Imageswebkr
- Web documents
API Reference
Tools
Search Blog
Searches for blogs on Naver using the given keyword.
Search News
Searches for news on Naver using the given keyword.
Search Book
Searches for book information on Naver using the given keyword.
Check Adult Query
Determines if the input query is an adult search term.
Search Encyclopedia
Searches for encyclopedia information on Naver using the given keyword.
Search Cafe Article
Searches for cafe articles on Naver using the given keyword.
Search KnowledgeiN
Searches for Knowledge iN Q&A on Naver using the given keyword.
Search Local
Searches for local business information using the given keyword.
Correct Errata
Converts Korean/English keyboard input errors.
Search Shop
Searches for shopping product information on Naver using the given keyword.
Search Document
Searches for academic papers, reports, etc. using the given keyword.
Search Image
Searches for images using the given keyword.
Search Web Document
Searches for web documents using the given keyword.
Resources
Available Search Categories
Returns a list of Naver search categories available on this MCP server.
Response Format
All tools return responses in structured text format, optimized for LLM processing:
Acknowledgements
License
This project is licensed under the MIT License - see the LICENSE file for details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Provides access to Naver Search APIs, allowing AI agents to search across multiple categories (blogs, news, books, images, shopping items, etc.) with structured responses optimized for LLM consumption.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.Last updated -108PythonMIT License
- -securityFlicense-qualityEnables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.Last updated -33Python
- AsecurityAlicenseAqualityAn MCP server that enables searching various content types (news, blogs, shopping, images, etc.) through Naver's search API.Last updated -191728TypeScriptMIT License
- AsecurityAlicenseAqualityA server that connects to Naver Maps and Search APIs, enabling geocoding and local search functionality for Korean locations.Last updated -2PythonMIT License