MCP Naver News

Busca artículos de noticias usando la API de Naver News. Requiere credenciales de la API de Naver News.

GitHub

Documentación

English | 한국어

MCP Naver News

License PyPI Version PyPI Downloads

Servidor de Model Context Protocol (MCP) para la API de Naver News. Esta integración permite una interacción segura y contextual con IA para Naver News, manteniendo la privacidad y seguridad de los datos.

Ejemplos de uso

Puedes solicitar al asistente de IA lo siguiente:

  • 📰 Búsqueda de noticias - "Encuentra noticias recientes sobre Samsung Electronics"
  • 🔍 Análisis de noticias - "Muéstrame las últimas noticias de tecnología"
  • 📊 Tendencias de noticias - "¿Qué temas son tendencia en las noticias económicas?"
  • ⚡ Actualizaciones en tiempo real - "Trae las últimas noticias sobre desarrollo de IA"

Demostración de funciones

[El video de demostración se agregará aquí]

Compatibilidad

FunciónEstado de soporteDescripción
Búsqueda de noticias✅ Soporte completoBúsqueda de artículos de noticias con varios parámetros
Ordenamiento de noticias✅ Soporte completoOrdenar por fecha o relevancia
Filtrado de noticias✅ Soporte completoFiltrar por rango de fechas y otros criterios

Guía de inicio rápido

1. Configuración de autenticación

Primero, obtén tus credenciales de la API de Naver News:

  1. Visita el Centro de desarrolladores de Naver
  2. Registra una aplicación
  3. Solicita acceso a la API de búsqueda de noticias
  4. Obtén tu Client ID y Client Secret

2. Instalación

# 저장소 클론
git clone https://github.com/ChangooLee/mcp-naver-news.git
cd mcp-naver-news

# [중요] Python 3.10 이상 사용 필수. 아래 'Python 3.10+ 설치 안내' 참고

# 가상 환경 생성
python3.10 -m venv .venv
source .venv/bin/activate

# 패키지 설치
# python 3.10 이상이 필요 
python3 -m pip install --upgrade pip
pip install -e .

Guía de instalación de Python 3.10+

Verifica la versión de Python (se requiere 3.10 o superior)

python3 --version

Si tu versión de Python es inferior a 3.10, sigue las instrucciones a continuación para instalar Python 3.10 o superior:

macOS

  • Descarga el instalador de Python más reciente desde el sitio web oficial: https://www.python.org/downloads/macos/
  • O si usas Homebrew: 
    brew install python@3.10
    Después de la instalación, es posible que necesites usar el comando python3.10.

Windows

  • Descarga y ejecuta el instalador de Python más reciente desde el sitio web oficial: https://www.python.org/downloads/windows/
  • Asegúrate de marcar la opción "Add Python to PATH" durante la instalación.
  • Después de la instalación, reinicia la terminal y usa el comando python o python3.

Linux (Ubuntu/Debian)

  • Actualiza la lista de paquetes e instala Python 3.10: 
    sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-distutils
  • Es posible que necesites usar el comando python3.10.

Linux (Fedora/CentOS/RHEL)

  • Instala Python 3.10: 
    sudo dnf install python3.10

Integración con IDE

MCP Naver News está diseñado para usarse con asistentes de IA mediante integración con IDE.

Configuración de Claude Desktop

  1. Haz clic en el menú de hamburguesa (☰) > Configuración > Desarrollador > botón "Editar configuración"
  2. Agrega la siguiente configuración:
{
  "mcpServers": {
    "mcp-naver-news": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-naver-news",
      "env": {
        "X_NAVER_CLIENT_ID": "YOUR_CLIENT_ID",
        "X_NAVER_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "MCP_SERVER_NAME": "mcp-naver-news",
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8000",
        "TRANSPORT": "stdio",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

[!NOTE]

  • YOUR_LOCATION: Reemplázalo con la ruta real donde está instalado el entorno virtual
  • YOUR_CLIENT_ID: Reemplázalo con tu Client ID de la API de Naver
  • YOUR_CLIENT_SECRET: Reemplázalo con tu Client Secret de la API de Naver

Variables de entorno

  • X_NAVER_CLIENT_ID: Client ID de la API de Naver
  • X_NAVER_CLIENT_SECRET: Client Secret de la API de Naver
  • MCP_SERVER_NAME: Nombre del servidor (valor predeterminado: mcp-naver-news)
  • MCP_HOST: Host del servidor (valor predeterminado: 0.0.0.0)
  • MCP_PORT: Puerto del servidor (valor predeterminado: 8000)
  • LOG_LEVEL: Nivel de registro (INFO, DEBUG, etc.)
  • LOG_FILE: Ruta del archivo de registro (valor predeterminado: naver_news.log)

Herramientas

Herramientas de Naver News

Estrategia de análisis recomendada: Para un análisis de noticias rápido y profundo, primero investiga y filtra rápidamente los artículos candidatos con search_news. Luego, solo cuando necesites una comprensión profunda o el análisis completo del texto, extrae y analiza el contenido de manera robusta con search_news_detail. Este flujo de trabajo de dos pasos ofrece tanto una exploración amplia como información precisa.

  • search_news: Devuelve rápidamente solo los resultados de la API de Naver News (título, resumen, enlace, etc.). No extrae el texto completo del artículo. Es adecuado para exploración rápida y resúmenes por palabras clave, y debe usarse primero.
  • search_news_detail: Después del filtrado inicial con search_news, extrae el texto completo de manera robusta desde la página real del artículo. Úsalo solo cuando necesites el texto exacto del artículo.

Flujo de trabajo recomendado

  1. Verifica rápidamente la lista de resúmenes de artículos por palabra clave con search_news.
  2. Para los artículos de interés, extrae el texto completo de manera robusta con search_news_detail para un análisis profundo.
Parámetros de las herramientas
HerramientaParámetroTipoDescripción
search_newsquerystringPalabra clave de búsqueda
displayintegerNúmero de resultados a mostrar (predeterminado: 10)
startintegerPosición inicial de los resultados (predeterminado: 1)
sortstringOpción de ordenamiento (sim: relevancia, date: fecha)
search_news_detailquerystringPalabra clave de búsqueda
displayintegerNúmero de resultados a mostrar (predeterminado: 10)
startintegerPosición inicial de los resultados (predeterminado: 1)
sortstringOpción de ordenamiento (sim: relevancia, date: fecha)
include_contentboolIncluir o no el texto completo del artículo (predeterminado: true)

Solución de problemas y depuración

Problemas comunes

  • Error de autenticación:

    • Verifica que el Client ID y el Secret sean válidos
    • Verifica que las credenciales de la API tengan los permisos necesarios
    • Verifica si se excedió el límite de llamadas a la API

  • Problemas de acceso a datos:

    • Algunos datos pueden requerir permisos adicionales
    • Verifica que los parámetros de búsqueda sean válidos
    • Verifica que la consulta esté formateada correctamente

  • Problemas de conexión:

    • Verifica la conexión a internet
    • Verifica la disponibilidad del servicio de la API de Naver
    • Verifica que el firewall no esté bloqueando la conexión

Herramientas de depuración

# 상세 로깅 활성화
export LOG_LEVEL=DEBUG

# 로그 보기
tail -f naver_news.log

# API 연결 테스트
python -m mcp_naver_news test-connection

Seguridad

  • Nunca compartas tus credenciales de la API
  • Mantén el archivo .env seguro y privado
  • Usa límites de velocidad adecuados
  • Monitorea el uso de la API
  • Almacena datos sensibles en variables de entorno

Contribuciones

¡Las contribuciones son bienvenidas! Para contribuir:

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad
  3. Aplica tus cambios
  4. Envía una solicitud de extracción (pull request)

Licencia

Este proyecto solo puede usarse con fines no comerciales y personales. El uso comercial, la redistribución y la explotación comercial de obras derivadas están estrictamente prohibidos.

Consulta el archivo LICENSE para conocer las condiciones detalladas.

Este no es un producto oficial de Naver. Naver es una marca registrada de Naver Corporation.