Skip to content

Latest commit

 

History

History
110 lines (73 loc) · 3.69 KB

README.md

File metadata and controls

110 lines (73 loc) · 3.69 KB
Raw

Scraping de Preços de Produtos KaBuM! e Envio para o Telegram

Índice

  1. Tecnologias Utilizadas
  2. Pré-requisitos
  3. Instalação e Configuração
    1. Criar o Bot no Telegram
    2. Instalar as Dependências
    3. Instalar Navegadores do Playwright
    4. Configurando o dotenv
  4. Executando o Script
  5. Configuração do GitHub Actions
  6. Resultado
  7. Contribuindo

1. Tecnologias Utilizadas

  • Playwright: Framework para automação de navegador, utilizado para realizar o scraping.
  • python-telegram-bot: Biblioteca para interação com a API do Telegram e envio de mensagens.
  • GitHub Actions: Ferramenta para automação de workflows, usada para agendar a execução diária do scraping.

2. Pré-requisitos

  • Python 3.7 ou superior
  • Conta no Telegram e criação de um Bot
  • Acesso ao repositório GitHub para configurar a automação

3. Instalação e Configuração

3.1 Criar o Bot no Telegram

Para interagir com o Telegram Bot, siga os passos abaixo:

  1. Abra o Telegram e procure por @BotFather.
  2. Envie o comando /newbot para o BotFather.
  3. Siga as instruções para criar o bot e obtenha o Token do Bot.
  4. Adicione o bot ao seu canal e obtenha o ID do Canal. Você pode usar o BotFather para encontrar o ID do canal.

3.2 Instalar as Dependências

Instale as dependências necessárias utilizando o pip:

pip install -r requirements.txt

3.3 Instalar Navegadores do Playwright

O Playwright requer que você instale os navegadores para o scraping. Execute o seguinte comando:

python -m playwright install

3.4 Configurando o dotenv

O arquivo .env será utilizado para armazenar as variáveis de ambiente, como o Token do Bot e o ID do Canal de forma segura.

Crie um arquivo chamado .env na raiz do seu projeto e adicione as seguintes variáveis:

TELEGRAM_TOKEN=SEU_TOKEN_AQUI
TELEGRAM_CHAT_ID=SEU_CHAT_ID_AQUI

Substitua SEU_TOKEN_AQUI pelo token do seu bot (obtido no passo 1) e SEU_CHAT_ID_AQUI pelo ID do seu canal.

4. Executando o Script

Agora, você pode executar o script que irá realizar a busca dos produtos e enviar as informações para o Telegram.

Execute o seguinte comando:

python main.py

Ou, se preferir, você pode rodar o script de forma automatizada utilizando GitHub Actions, que pode ser configurado para rodar diariamente e enviar atualizações do preço para o Telegram.

5. Configuração do GitHub Actions

O projeto está configurado para rodar automaticamente todos os dias às 01:00 (horário de Brasília). Para isso, foi criado um workflow utilizando GitHub Actions. O arquivo de configuração está localizado em .github/workflows/web-scraping.yml.

Se você deseja rodar o workflow manualmente ou de forma agendada, o cronograma está configurado para rodar todos os dias às 01:00:

on:
schedule:
- cron: '0 4 * 11 *' # Executa todos os dias às 04:00 UTC (01:00 Brasília) somente em novembro
workflow_dispatch:  # Permite a execução manual também

6. Resultado

7. Contribuindo

Se você deseja apoiar este projeto, deixe um ⭐.

Feito com 💙 por Marco Antonio.