Naver OpenAPI

The Naver MCP Server is an implementation of the Naver OpenAPI service based on the Model Context Protocol (MCP), providing interaction tools for multiple Naver services.

Search tools Developer tools #Naver Search #API Service #Data Query #Content Retrieval .Python

rating : 3 points

downloads : 116

update time : 2025-04-28

What is the Naver MCP Server?

The Naver MCP Server is a tool based on the Model Context Protocol (MCP) for integrating and invoking various services provided by Naver OpenAPI. It helps users easily search for content such as blogs, news, books, and local information.

How to use the Naver MCP Server?

You need to apply for Naver OpenAPI access rights and set your client ID and secret through a configuration file or environment variables. Then, you can start the server using the command line and begin using it.

Applicable Scenarios

Suitable for applications that need to quickly integrate Naver search functions, such as content recommendation systems and search engine optimization tools.

Main Features

Blog SearchSearch for relevant content in Naver blogs based on keywords.

News SearchSearch for relevant content in Naver news based on keywords.

Book SearchSearch for relevant content in the Naver book library based on keywords.

Adult Content CheckDetect whether the input keywords involve adult content.

Encyclopedia SearchSearch for relevant content in the Naver encyclopedia based on keywords.

Cafe Article SearchSearch for relevant content in Naver cafes based on keywords.

Q&A SearchSearch for relevant content in the Naver Q&A library based on keywords.

Local SearchSearch for relevant content in Naver local services based on keywords.

Spelling CorrectionAutomatically correct spelling errors in the input text.

Web SearchSearch for relevant content in Naver web pages based on keywords.

Image SearchSearch for relevant content in the Naver image library based on keywords.

Shopping SearchSearch for relevant content in the Naver shopping library based on keywords.

Document SearchSearch for relevant content in the Naver document library based on keywords.

Advantages and Limitations

Advantages

Supports integration of multiple Naver services

Easy to install and configure

Provides a rich set of API interfaces

Limitations

Requires application for Naver OpenAPI access rights

Some advanced features may require additional payment

How to Use

Apply for Naver OpenAPI Access Rights

Visit the Naver Developer Platform and register your application to obtain a client ID and secret.

Install the Naver MCP Server

Install the server via pip and configure environment variables.

Start the Server

Start the server using the command line and begin using it.

Usage Examples

Blog Search ExampleDemonstrate how to use the blog search function.

News Search ExampleDemonstrate how to use the news search function.

Frequently Asked Questions

How to apply for Naver OpenAPI access rights?

How to start the Naver MCP Server?

Related Resources

Naver OpenAPI Documentation

Official documentation for Naver OpenAPI.

GitHub Repository

Open - source code repository for the Naver MCP Server.

🚀 Naver MCP Server

A Naver OpenAPI server implemented using the Model Context Protocol (MCP). This project provides tools for interacting with various Naver services, such as searching blogs, news, books, etc.

🚀 Quick Start

To use the Naver MCP server, you need to apply for access to the Naver OpenAPI. You can register at the following link:

https://developers.naver.com/apps/#/register=datalab

📦 Installation

Install via PyPi (Claude Desktop)

Install using Claude Desktop:

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Run directly on Claude Desktop:

pip install mcp-naver

python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Install via PyPi (Cursor)

Install on Cursor:

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.cursor \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Install from Source Code

# Clone the repository
git clone https://github.com/pfldy2850/py-mcp-naver.git

# Install dependencies and run
pip install -r requirements.txt
python main.py

✨ Features

This server provides various tools for interacting with Naver services. The main features are as follows:

Blog Search: Search Naver blog content using the search_blog function.
News Search: Find relevant news reports using search_news.
Web Search: Conduct general web searches using search_webkr.
Image Search: Search for images using search_image and set filters.
Shopping Search: Browse product information using search_shop and support filtering.

💻 Usage Examples

Installation and Configuration

Clone the repository and install dependencies:

git clone https://github.com/pfldy2850/py-mcp-naver.git
cd py-mcp-naver
pip install -r requirements.txt

Configure environment variables or set the Naver API client ID and secret directly in the code.

Basic Usage

from mcp_server import NaverMCP

# Initialize the server instance
naver = NaverMCP(client_id="your_client_id", client_secret="your_client_secret")

# Search for blog content
blogs = naver.search_blog(query="Python development")
print(blogs)