Servidor MCP de búsqueda de Naver

Este servidor MCP (Protocolo de comunicación multiplataforma) proporciona acceso a las API de búsqueda de Naver, lo que permite a los agentes de IA buscar distintos tipos de contenido en Naver.

Descripción general

Busque blogs, noticias, libros, imágenes, artículos de compra y más.
Múltiples categorías de búsqueda con soporte de paginación
Respuestas de texto estructuradas y optimizadas para el consumo de LLM
Comprobar contenido para adultos
Convertir errores de entrada del teclado (erratas)

Configuración

Prerrequisitos

Python 3.12+
Credenciales de la API para desarrolladores de Naver
- Puede obtener estas credenciales registrándose en el portal de desarrolladores de Naver .
- También puedes consultar mi blog Naver Search API MCP Server .

Instalación

Clonar el repositorio:

git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search

instalación de uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Cree un entorno virtual e instale dependencias:

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt

Cree un archivo .env con sus credenciales de API de Naver:

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Usando Docker

Construya la imagen de Docker:

docker build -t py-mcp-naver-search .

Ejecute el contenedor:

docker run py-mcp-naver-search

Uso local

Ejecutar el servidor:

mcp run server.py

Configurar los ajustes de MCP

Agregue la configuración del servidor a su archivo de configuración de MCP:

Aplicación de escritorio de Claude

Para instalar automáticamente a través de Smithery :

npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude

Para instalar manualmente, abra ~/Library/Application Support/Claude/claude_desktop_config.json

Agregue esto al objeto mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

IDE de cursor

abrir ~/.cursor/mcp.json

Agregue esto al objeto mcpServers :

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

para Docker

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-naver-search"
      ]
    }
  }
}

Uso del cliente

El repositorio incluye un script de cliente para realizar pruebas:

# 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"

Categorías de búsqueda disponibles

El servidor admite las siguientes categorías de búsqueda:

blog - Entradas del blog
news - Artículos de noticias
book - Libros
adult - Verificación de contenido para adultos
encyc - Entradas de la enciclopedia
cafe_article - Artículos de cafetería
kin - Conocimiento en preguntas y respuestas
local - Información comercial local
errata - Corrección de errores de entrada del teclado
shop - Artículos de compra
doc - Artículos y documentos académicos
image - Imágenes
webkr - Documentos web

Referencia de API

Herramientas

Buscar en el blog

search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca blogs en Naver usando la palabra clave dada.

Buscar noticias

search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca noticias en Naver utilizando la palabra clave dada.

Buscar libro

search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca información de libros en Naver utilizando la palabra clave proporcionada.

Consulta de adultos

check_adult_query(query: str) -> str

Determina si la consulta de entrada es un término de búsqueda para adultos.

Buscar en la enciclopedia

search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca información enciclopédica sobre Naver utilizando la palabra clave dada.

Buscar artículo de Cafe

search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca artículos de cafetería en Naver usando la palabra clave dada.

Buscar KnowledgeiN

search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca Knowledge iN Q&A en Naver usando la palabra clave proporcionada.

Buscar local

search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str

Busca información comercial local utilizando la palabra clave proporcionada.

Corregir erratas

correct_errata(query: str) -> str

Convierte errores de entrada del teclado coreano/inglés.

Buscar tienda

search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

Busca información sobre productos de compras en Naver utilizando la palabra clave proporcionada.

Buscar documento

search_doc(query: str, display: int = 10, page: int = 1) -> str

Busca artículos académicos, informes, etc. utilizando la palabra clave dada.

Buscar imagen

search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str

Busca imágenes utilizando la palabra clave dada.

Buscar documento web

search_webkr(query: str, display: int = 10, page: int = 1) -> str

Busca documentos web utilizando la palabra clave dada.

Recursos

Categorías de búsqueda disponibles

GET http://localhost:8000/available-search-categories

Devuelve una lista de categorías de búsqueda de Naver disponibles en este servidor MCP.

Formato de respuesta

Todas las herramientas devuelven respuestas en formato de texto estructurado, optimizado para el procesamiento 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
...

Expresiones de gratitud

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Integrations