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)

Related MCP server: KiMCP

Tabla de contenido

• Prerrequisitos

• Instalación

• Configurar los ajustes de MCP

• Referencia de API

• Expresiones de gratitud

• Licencia

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

1. Clonar el repositorio:

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

2. instalación de uv

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

3. Cree un entorno virtual e instale dependencias:

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

4. 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

1. Construya la imagen de Docker:

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

2. Ejecute el contenedor:

docker run py-mcp-naver-search

Uso local

1. 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

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

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

2. 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:

1. blog - Entradas del blog

2. news - Artículos de noticias

3. book - Libros

4. adult - Verificación de contenido para adultos

5. encyc - Entradas de la enciclopedia

6. cafe_article - Artículos de cafetería

7. kin - Conocimiento en preguntas y respuestas

8. local - Información comercial local

9. errata - Corrección de errores de entrada del teclado

10. shop - Artículos de compra

11. doc - Artículos y documentos académicos

12. image - Imágenes

13. 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

• Blog del servidor MCP de la API de búsqueda de Naver

• API abierta de Naver

• Protocolo MCP

Licencia

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