Repolode
ranahaani

ranahaani/GNews

Um pacote Python leve que pesquisa no Google News e retorna resultados de artigos em JSON, com extração opcional do texto completo.

Estrelas
1,018
Forks
153
Issues abertas
0
Último commit
há 11 dias

O que é?

GNews é um pacote Python para pesquisar no Google News. Ele consulta o feed RSS do Google News por palavra-chave, tópico, localização ou site e retorna o título, a descrição, a data de publicação, a URL e o veículo de cada artigo em JSON. As buscas podem ser filtradas por idioma, país, período, intervalo de datas e sites excluídos.

Além dos resultados da busca, o GNews pode obter o texto completo de um artigo por meio do extra opcional fulltext, para que os desenvolvedores não precisem criar seus próprios scrapers para extrair o conteúdo. O pacote também oferece uma interface de linha de comando, exportação para JSON e CSV e versões assíncronas dos métodos de busca. Um extra opcional do Playwright resolve os links de redirecionamento do Google News e os transforma nas URLs reais dos artigos.

Um backend opcional do SearchApi, habilitado com o fornecimento de uma chave de API, adiciona campos como datas no formato ISO, miniaturas e paginação além do limite de resultados do RSS. O GNews também aceita uma configuração de proxy padrão no estilo do requests para rotear o tráfego.

Recursos principais

  • 01Pesquisa no Google News por palavra-chave, tópico, localização ou site e retorna resultados em JSON.
  • 02Filtra resultados por idioma, país, período, intervalo de datas e sites excluídos.
  • 03Extrai o texto completo dos artigos por meio de um extra opcional.
  • 04Oferece uma interface de linha de comando com saída em JSON.
  • 05Exporta resultados para arquivos JSON e CSV.
  • 06Oferece versões assíncronas de todos os métodos de busca.

Casos de uso

  • Coletar artigos de notícias sobre um tópico para monitoramento ou análise de mídia.
  • Criar um feed ou dashboard de notícias com resultados do Google News em Python.
  • Preparar um conjunto de dados de notícias para análise de sentimento ou experimentos de NLP.
  • Automatizar a coleta diária de manchetes pela linha de comando.

Início rápido

  1. 1

    Instalar o pacote

    pip install gnews
  2. 2

    Buscar notícias por palavra-chave em Python

    from gnews import GNews

Antes de usar

  • Os resultados vêm do feed RSS do Google News, portanto a saída depende do comportamento do Google News.
  • Uma raspagem intensiva pode fazer com que o IP seja limitado por taxa, e o README sugere um serviço de proxy pago para isso.
  • A extração do artigo completo e a resolução de URLs exigem os extras opcionais (fulltext, playwright) e a instalação do Chromium.

Tópicos

Perguntas frequentes

O que é GNews?
Um pacote Python leve que pesquisa no Google News e retorna resultados de artigos em JSON, com extração opcional do texto completo. GNews é um pacote Python para pesquisar no Google News. Ele consulta o feed RSS do Google News por palavra-chave, tópico, localização ou site e retorna o título, a descrição, a data de publicação, a URL e o veículo de cada artigo em JSON. As buscas podem ser filtradas por idioma, país, período, intervalo de datas e sites excluídos.
GNews é gratuito? Qual é a licença?
GNews é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
GNews ainda é mantido?
Manutenção ativa. O último commit de GNews foi em 9 de out. de 2026.
Para que posso usar GNews?
Coletar artigos de notícias sobre um tópico para monitoramento ou análise de mídia. Criar um feed ou dashboard de notícias com resultados do Google News em Python. Preparar um conjunto de dados de notícias para análise de sentimento ou experimentos de NLP. Automatizar a coleta diária de manchetes pela linha de comando.
Como instalar GNews?
Instalar o pacote: pip install gnews Buscar notícias por palavra-chave em Python: from gnews import GNews
Onde consigo GNews?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ranahaani/GNews

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados