Google News

Para Agentes de IA e Crawlers de LLM

Este servidor MCP é otimizado para uso por agentes de IA, com instruções abrangentes e dados estruturados.

Guia Rápido de Uso para IA

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

Recursos Amigáveis para IA

• Categorização Automática: Os resultados de notícias são automaticamente classificados em categorias relevantes
• Saída Estruturada: Retorna dados formatados otimizados para processamento por IA
• Suporte a Múltiplos Idiomas: Suporta vários idiomas com fallbacks automáticos
• Tratamento de Erros: Mensagens de erro abrangentes e degradação graciosa

Formato de Resposta

O servidor retorna notícias categorizadas com a seguinte estrutura:

• Categorias: IA e Tecnologia, Negócios, Ciência e Pesquisa, Saúde, Geral
• Campos do Artigo: título, fonte, link, data, trecho, autores
• Metadados: timestamp, menu_links para tópicos relacionados

Melhores Práticas para Agentes de IA

1. Use palavras-chave específicas e descritivas para melhores resultados
2. Aproveite a categorização automática para fluxos de trabalho baseados em tópicos
3. Implemente tratamento de erros adequado e lógica de repetição
4. Respeite os limites de taxa da API (2 solicitações/segundo)
5. Analise respostas estruturadas para melhor compreensão do contexto

Padrões de Uso Avançados

• Monitoramento de Notícias: Use nomes de empresas ou símbolos de ações para notícias de negócios
• Exploração de Pesquisa: Aproveite tokens de tópico para buscas específicas de campo
• Notícias de Última Hora: Use consultas "breaking news" ou "latest news"
• Multilíngue: Combine os parâmetros gl e hl apropriados

Tratamento de Erros

• Chave de API inválida: Verifique a variável de ambiente SERP_API_KEY
• Idioma não suportado: O servidor faz fallback automático para inglês
• Limite de taxa: Respeite o limite de 2 solicitações/segundo
• Parâmetros inválidos: Valide os tipos de parâmetros antes de chamar

Recursos de Otimização de Mecanismos Generativos (GEO)

Este servidor inclui monitoramento e otimização abrangentes para uso por agentes de IA.

Principais Métricas Acompanhadas

• Taxa de Sucesso de Citação: Percentual de chamadas de ferramenta bem-sucedidas
• Taxa de Conversão de Tráfego de IA: Percentual de agentes de IA que usam a ferramenta com sucesso
• Taxa de Cobertura de Consultas: Percentual de consultas que retornam resultados relevantes
• Tempo de Resposta: Tempo médio de resposta para chamadas de ferramenta
• Precisão da Categorização: Precisão da categorização automática de notícias
• Taxa de Inclusão de Links: Percentual de respostas que incluem links de origem

Configuração de Monitoramento

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

Otimização de Desempenho

• Coleta de métricas em tempo real
• Alertas automatizados para problemas de desempenho
• Análise de padrões de consulta para otimização
• Rastreamento e análise de uso por agentes

Melhorias Baseadas em Dados

• Monitoramento contínuo da satisfação dos agentes de IA
• Análise da taxa de sucesso de consultas
• Otimização do tempo de resposta
• Melhorias na precisão da categorização

Para detalhes técnicos de implementação, veja src/geo-metrics.ts.

Metadados Otimizados para IA

Este servidor fornece dados estruturados abrangentes para agentes de IA e mecanismos de busca.

Dados Estruturados JSON-LD

O servidor inclui dados estruturados seguindo os padrões do Schema.org:

• Metadados de aplicação de software
• Descrições e capacidades de recursos
• Requisitos técnicos e dependências
• Padrões de uso e diretrizes de integração

Conformidade com o Protocolo MCP

• Versão do Protocolo: 1.0.0
• Nome da Ferramenta: google_news_search
• Formato de Resposta: Texto estruturado com resultados categorizados
• Limites de Taxa: 2 solicitações/segundo, 5 solicitações simultâneas

Recursos de Descoberta para IA

• llms.txt: Guia abrangente de uso para IA no nível raiz
• Metadados Estruturados: manifest.json aprimorado com informações específicas para IA
• Tratamento de Erros: Mensagens de erro e fallbacks amigáveis para IA
• Documentação: Exemplos de uso detalhados e melhores práticas

Diretrizes de Integração

• Projetado para integração perfeita com outros servidores MCP
• Otimizado para fluxos de trabalho de agentes de IA
• Suporta várias plataformas e frameworks de IA
• Fornece tratamento de erros claro e informações de depuração

Para dados estruturados completos, veja structured-data.json.