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
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.
https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779
✨ 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:
-
Visita el sitio web de SerpApi y crea una cuenta
-
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
-
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.
-
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
- Instala las dependencias:
npm install
- Compila el servidor:
npm run build
- Configura el entorno:
Modifica tu
claude_desktop_config.jsoncon 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"
}
}
- Inicia el servidor:
npm start
Solución de problemas
- 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
- 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
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 Processantes 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
📖 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úsquedagl: 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íficospublication_token: Token para editores específicosstory_token: Token para cobertura completa de una historiasection_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.
🤖 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
- Usa palabras clave específicas y descriptivas para mejores resultados
- Aprovecha la categorización automática para flujos de trabajo basados en temas
- Implementa un manejo de errores adecuado y lógica de reintentos
- Respeta los límites de tasa de la API (2 solicitudes/segundo)
- 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.
