News Fact-Checker

Verificação automatizada de fatos em manchetes de notícias usando pesquisa na web e Google Gemini AI.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP News Fact-Checker

Um servidor moderno de Protocolo de Contexto de Modelo (MCP) para verificação de fatos em manchetes de notícias usando análise de IA e pesquisa na web.

Recursos

  • 🔍 Verificação de Fatos em Manchetes: Verifique alegações de notícias usando IA do Google Gemini e pesquisa na web
  • 📈 Tópicos em Alta: Obtenha notícias em alta atuais a partir de feeds RSS
  • 🤖 Análise com IA: Usa Google Gemini 2.0 Flash para verificação inteligente de fatos
  • 🌐 Verificação Multi-Fonte: Pesquisa em múltiplas fontes para análise abrangente
  • ⚡ MCP Moderno: Construído com as convenções MCP mais recentes usando decoradores @mcp.tool

Início Rápido

Pré-requisitos

  • Python 3.11 ou superior
  • Chave de API do Google Gemini

Instalação

  1. Clone o repositório:
git clone <repository-url>
cd FactChecker
  1. Instale as dependências:
pip install -r requirements.txt
  1. Configure sua chave de API:
export GEMINI_API_KEY="your_gemini_api_key_here"
  1. Execute o servidor:
python -m factchck.news_factcheck

Uso

Verificar Fatos em uma Manchete

# Example MCP tool call
{
    "tool": "fact_check_headline",
    "arguments": {
        "headline": "NASA announces discovery of water on Mars"
    }
}

Obter Tópicos em Alta

# Example MCP tool call
{
    "tool": "get_trending_topics",
    "arguments": {
        "location": "international"  # or "local", "india"
    }
}

Ferramentas Disponíveis

fact_check_headline

Verifica manchetes de notícias usando análise de IA e pesquisa na web.

Parâmetros:

  • headline (string): A manchete de notícia a ser verificada

Retornos:

  • Veredito (VERDADEIRO/FALSO/PARCIALMENTE_VERDADEIRO/NÃO_VERIFICADO/ENGANOSO)
  • Pontuação de confiança
  • Percentual de veracidade
  • Evidências de apoio e contradição
  • Recomendações

get_trending_topics

Recupera tópicos de notícias em alta atuais.

Parâmetros:

  • location (string, opcional): "internacional", "local" ou "india" (padrão: "internacional")

Retornos:

  • Lista de tópicos em alta com títulos, fontes e URLs

Configuração

Variáveis de Ambiente

  • GEMINI_API_KEY: Chave de API do Google Gemini (obrigatória)
  • NEWS_API_KEY: Chave opcional do NewsAPI para pesquisa aprimorada
  • SEARCH_API_KEY: Chave opcional de API de pesquisa adicional

Chaves de API

  1. Google Gemini: Obtenha sua chave de API no Google AI Studio
  2. NewsAPI (opcional): Obtenha no NewsAPI
  3. API de Pesquisa (opcional): Chave de API de serviço de pesquisa adicional

Desenvolvimento

Estrutura do Projeto

FactChecker/
├── src/
│   └── factchck/
│       └── news_factcheck.py  # Main MCP server
├── requirements.txt           # Python dependencies
├── pyproject.toml           # Project configuration
└── README.md               # This file

Compilação

# Install in development mode
pip install -e .

# Run tests (if available)
python -m pytest

Integração MCP

Este servidor é compatível com:

  • Claude Desktop
  • CLI MCP
  • Qualquer cliente compatível com MCP

Configuração do Servidor

{
    "mcpServers": {
        "news-factcheck": {
            "command": "python",
            "args": ["-m", "factchck.news_factcheck"],
            "env": {
                "GEMINI_API_KEY": "your_api_key_here"
            }
        }
    }
}

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

  • Chaves de API ausentes
  • Problemas de conectividade de rede
  • Validação de entrada inválida
  • Indisponibilidade do serviço

Limitações

  • Requer conexão com a internet para pesquisa na web
  • Depende da disponibilidade da API do Google Gemini
  • A análise de feeds RSS é simplificada (considere usar um analisador XML adequado para produção)
  • Limites de taxa podem ser aplicados aos serviços de API

Contribuição

  1. Faça um fork do repositório
  2. Crie um branch de recurso
  3. Faça suas alterações
  4. Adicione testes, se aplicável
  5. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Histórico de Versões

  • v3.0.0: Modernizado com as convenções MCP mais recentes, base de código simplificada
  • v2.1.0: Versão anterior com pesquisa multi-fonte complexa
  • v0.1.0: Lançamento inicial

Suporte

Para problemas e perguntas:

  1. Verifique os logs de erro
  2. Verifique a configuração da chave de API
  3. Garanta a conectividade de rede
  4. Abra um problema no GitHub