Google News

Capacidades de búsqueda de Google News con categorización automática de temas y soporte multilingüe mediante integración con SerpAPI.

Documentación

MseeP.ai Security Assessment Badge


Google News MCP Server


PulseMCP Badge

Una implementación de servidor de Model Context Protocol (MCP) que proporciona capacidades de búsqueda de Google News mediante la integración con SerpAPI. Categoriza automáticamente los resultados de noticias y admite múltiples idiomas y regiones.

Google News Server MCP server


👉Try It Now!👈


https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

屏幕截图 2024-12-30 021446

屏幕截图 2024-12-30 021524

屏幕截图 2024-12-30 021914

屏幕截图 2024-12-30 021941

✨ Características

🔍 Opciones de búsqueda flexibles

Capacidades integrales de búsqueda, incluida la búsqueda basada en consultas, búsqueda por temas, filtrado por publicación y cobertura de historias.

🌐 Cobertura global

Admite múltiples idiomas y regiones mediante códigos de idioma y país configurables.

📊 Categorización inteligente

Categoriza automáticamente los resultados de noticias en temas como IA y Tecnología, Negocios, Ciencia e Investigación, y Salud.

🔀 Múltiples tipos de resultados

Maneja varios tipos de resultados de noticias, incluidos titulares, historias, temas relacionados y enlaces de menú.

🛠️ Manejo robusto de errores

Manejo integral de errores para fallos de API y entradas no válidas, con mensajes de error útiles.

🌍 Soporte de idiomas

Retroceso automático al inglés para códigos de idioma no compatibles con notificaciones apropiadas al usuario.

🔑 Guía de configuración de SerpApi

Antes de comenzar, necesitarás obtener una clave de SerpApi. Así es cómo:

  1. Visita el sitio web de SerpApi y crea una cuenta

  2. Después del registro, ve a tu Panel de control:

    • Localiza la sección "API Key"
    • Copia tu clave de API
    • Los nuevos usuarios reciben 250 llamadas de API gratuitas
  3. Detalles de uso de la API:

    • Nivel gratuito: 250 búsquedas por mes
    • Los planes de pago comienzan en $75/mes por 5000 búsquedas
    • Facturación basada en llamadas de API exitosas
    • Múltiples métodos de pago: Tarjeta de crédito, PayPal, etc.
  4. Límites de uso:

    • Tasa de solicitudes: 2 solicitudes/segundo
    • Restricciones de IP: Ninguna
    • Solicitudes concurrentes: 5
    • Tiempo de caché de respuesta: 1 hora

👩‍🔧 Solución para problemas de conexión de servidores MCP con NVM/NPM

Haz clic para ver mi solución de configuración 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Inicio rápido

  1. Instala las dependencias:
npm install
  1. Compila el servidor:
npm run build
  1. Configura el entorno: Modifica tu claude_desktop_config.json con el siguiente contenido (ajusta las rutas según tu sistema):
    "google-news": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\github_repository\\path_to\\dist\\index.js"
      ],
      "env": {
        "SERP_API_KEY": "your-api-key"
      }
    }
  1. Inicia el servidor:
npm start

Solución de problemas

  1. Clave de API no válida
  • Verifica la configuración de la clave de API en claude_desktop_config.json
  • Confirma que la clave de API esté activa en el panel de SERP API
  1. Fallos en las solicitudes
  • Verifica la conectividad de red
  • Confirma que la cuota de llamadas de API no se haya excedido
  • Valida el formato de los parámetros de la solicitud

Ejecución de evaluaciones

El paquete de evaluaciones carga un cliente mcp que luego ejecuta el archivo index.ts, por lo que no es necesario recompilar entre pruebas. Puedes cargar variables de entorno prefijando el comando npx. La documentación completa se puede encontrar aquí.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

📦 Instalación

Instalación mediante Smithery

Para instalar Google News para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Trust Score smithery badge

Instalación mediante mcp-get

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

Si estás usando una versión antigua de Windows PowerShell, es posible que necesites ejecutar Set-ExecutionPolicy Bypass -Scope Process antes de este comando.

Instalación manual

@chanmeng666/google-news-server

# Using npm
npm i @chanmeng666/google-news-server
# or
npm install @chanmeng666/google-news-server

# Using yarn
yarn add @chanmeng666/google-news-server

# Using pnpm
pnpm add @chanmeng666/google-news-server

💻 Stack tecnológico

TypeScript NodeJS MCP

📖 Documentación de la API

El servidor implementa el Model Context Protocol y expone una herramienta de búsqueda de Google News con los siguientes parámetros:

  • q: Cadena de consulta de búsqueda
  • gl: Código de país (por ejemplo, 'us', 'uk')
  • hl: Código de idioma (por ejemplo, 'en', 'es')
  • topic_token: Token para temas de noticias específicos
  • publication_token: Token para editores específicos
  • story_token: Token para cobertura completa de una historia
  • section_token: Token para secciones específicas

🔧 Desarrollo

# Run in development mode with hot reload
npm run dev

# Run linting
npm run lint

# Run tests
npm run test

📝 Licencia

Este proyecto está licenciado bajo MIT.

🙋‍♀ Autora

Creado y mantenido por Chan Meng. GitHub LinkedIn


🤖 Instrucciones para agentes de IA y optimización GEO

Para agentes de IA y rastreadores de LLM

Este servidor MCP está optimizado para el uso de agentes de IA con instrucciones integrales y datos estructurados.

Guía rápida de uso de IA

{
  "tool": "google_news_search",
  "parameters": {
    "q": "artificial intelligence latest developments",
    "gl": "us",
    "hl": "en"
  }
}

Características amigables para IA

  • Categorización automática: Los resultados de noticias se clasifican automáticamente en categorías relevantes
  • Salida estructurada: Devuelve datos formateados optimizados para el procesamiento de IA
  • Soporte multilingüe: Admite varios idiomas con retrocesos automáticos
  • Manejo de errores: Mensajes de error integrales y degradación elegante

Formato de respuesta

El servidor devuelve noticias categorizadas con la siguiente estructura:

  • Categorías: IA y Tecnología, Negocios, Ciencia e Investigación, Salud, General
  • Campos de artículo: título, fuente, enlace, fecha, fragmento, autores
  • Metadatos: marca de tiempo, enlaces de menú para temas relacionados

Mejores prácticas para agentes de IA

  1. Usa palabras clave específicas y descriptivas para mejores resultados
  2. Aprovecha la categorización automática para flujos de trabajo basados en temas
  3. Implementa un manejo de errores adecuado y lógica de reintentos
  4. Respeta los límites de tasa de la API (2 solicitudes/segundo)
  5. Analiza las respuestas estructuradas para una mejor comprensión del contexto

Patrones de uso avanzados

  • Monitoreo de noticias: Usa nombres de empresas o símbolos bursátiles para noticias de negocios
  • Exploración de investigación: Aprovecha los tokens de temas para búsquedas específicas de campo
  • Noticias de última hora: Usa consultas de "breaking news" o "latest news"
  • Multilingüe: Combina los parámetros gl y hl apropiados

Manejo de errores

  • Clave de API no válida: Verifica la variable de entorno SERP_API_KEY
  • Idioma no compatible: El servidor retrocede automáticamente al inglés
  • Límite de tasa: Respeta el límite de 2 solicitudes/segundo
  • Parámetros no válidos: Valida los tipos de parámetros antes de llamar
📊 Métricas GEO y monitoreo

Características de optimización para motores generativos (GEO)

Este servidor incluye monitoreo y optimización integrales para el uso de agentes de IA.

Métricas clave rastreadas

  • Tasa de éxito de citas: Porcentaje de llamadas de herramientas exitosas
  • Tasa de conversión de tráfico de IA: Porcentaje de agentes de IA que usan la herramienta con éxito
  • Tasa de cobertura de consultas: Porcentaje de consultas que devuelven resultados relevantes
  • Tiempo de respuesta: Tiempo promedio de respuesta para llamadas de herramientas
  • Precisión de categorización: Precisión de la categorización automática de noticias
  • Tasa de entrega de enlaces: Porcentaje de respuestas que incluyen enlaces de fuentes

Configuración de monitoreo

interface GEOMonitoringConfig {
  trackingEnabled: boolean;
  metricsEndpoint: string;
  reportingInterval: number; // minutes
  alertThresholds: {
    errorRate: number;
    responseTime: number;
    successRate: number;
    satisfactionScore: number;
  };
}

Optimización del rendimiento

  • Recopilación de métricas en tiempo real
  • Alertas automatizadas para problemas de rendimiento
  • Análisis de patrones de consultas para optimización
  • Seguimiento y análisis del uso de agentes

Mejoras basadas en datos

  • Monitoreo continuo de la satisfacción de los agentes de IA
  • Análisis de la tasa de éxito de consultas
  • Optimización del tiempo de respuesta
  • Mejoras en la precisión de la categorización

Para detalles de implementación técnica, consulta src/geo-metrics.ts.

🔍 Datos estructurados y metadatos

Metadatos optimizados para IA

Este servidor proporciona datos estructurados integrales para agentes de IA y motores de búsqueda.

Datos estructurados JSON-LD

El servidor incluye datos estructurados que siguen los estándares de Schema.org:

  • Metadatos de aplicaciones de software
  • Descripciones de características y capacidades
  • Requisitos técnicos y dependencias
  • Patrones de uso y pautas de integración

Cumplimiento del protocolo MCP

  • Versión del protocolo: 1.0.0
  • Nombre de la herramienta: google_news_search
  • Formato de respuesta: Texto estructurado con resultados categorizados
  • Límites de tasa: 2 solicitudes/segundo, 5 solicitudes concurrentes

Características de descubrimiento de IA

  • llms.txt: Guía integral de uso de IA en el nivel raíz
  • Metadatos estructurados: manifest.json mejorado con información específica de IA
  • Manejo de errores: Mensajes de error amigables para IA y retrocesos
  • Documentación: Ejemplos de uso detallados y mejores prácticas

Pautas de integración

  • Diseñado para una integración perfecta con otros servidores MCP
  • Optimizado para flujos de trabajo de agentes de IA
  • Admite varias plataformas y marcos de IA
  • Proporciona manejo de errores claro e información de depuración

Para datos estructurados completos, consulta structured-data.json.

Implementación alojada

Hay una implementación alojada disponible en Fronteir AI.


Chan Meng

Chan Meng
¿Necesitas una aplicación personalizada como esta? Yo las creo — hablemos.

Email Chan Meng Chan Meng on GitHub