Skip to content

README.md

Latest commit

 

History

History
176 lines (129 loc) · 5.18 KB

README.md

File metadata and controls

176 lines (129 loc) · 5.18 KB
Raw

Projetos em Python

Status Python Selenium WhatsApp Instagram

Repositório com pequenos sistemas em Python para estudo e uso pessoal. Cada pasta raiz representa um sistema independente, com seu próprio README, scripts e dependências.

Use estes scripts com responsabilidade. Automações em plataformas como WhatsApp, Instagram e Google podem quebrar com mudanças de interface e devem respeitar termos de uso, limites de envio e privacidade dos usuários.

Como o repositório está organizado

Este projeto está mais próximo de um monorepo de automações do que de um pacote Python único. Por isso, a organização recomendada é manter cada sistema isolado em sua própria pasta:

  • busca_automatica_google/: automação de buscas no Google com Selenium.
  • instagrambot/: scripts de automação para Instagram.
  • whatsappbot/: scripts simples de envio pelo WhatsApp Web.
  • wppmessage/: aplicação desktop PyQt5 para envio/agendamento de mensagens.

O utilitário decifra_base64.py foi movido para a branch legacy e não faz parte da branch principal.

Projetos

Sistema Descrição Como instalar Documentação
busca_automatica_google/ Automação de busca e navegação no Google. pip install -r busca_automatica_google/requirements.txt README
instagrambot/ Bots para curtir, comentar, seguir e coletar dados do Instagram. pip install -r instagrambot/requirements.txt README
whatsappbot/ Scripts para envio automatizado de mensagens no WhatsApp Web. pip install -r whatsappbot/requirements.txt README
wppmessage/ Aplicação desktop para envio/agendamento de mensagens no WhatsApp. pip install -r wppmessage/requirements.txt README

Estrutura

python/
├── busca_automatica_google/
│   ├── README.md
│   ├── busca_google.py
│   ├── requirements.txt
│   └── screen.png
├── instagrambot/
│   ├── README.md
│   ├── requirements.txt
│   └── *.py
├── whatsappbot/
│   ├── README.md
│   ├── requirements.txt
│   └── *.py
├── wppmessage/
│   ├── README.md
│   ├── requirements.txt
│   ├── imagens/
│   ├── versao1_0_single_number/
│   └── versao1_1_multiple_numbers/
├── .gitignore
└── README.md

Quick Start

Requisitos

  • Python 3.9+
  • pip
  • Google Chrome, para scripts que usam Chrome/WhatsApp Web/Google
  • Firefox, para scripts do Instagram
  • Conta logada no WhatsApp Web quando o sistema depender disso

1. Clonar o repositório

git clone git@github.com:flaviooliveira-code/python.git
cd python

2. Criar ambiente virtual

python3 -m venv .venv
source .venv/bin/activate

No Windows:

python -m venv .venv
.venv\Scripts\activate

3. Instalar somente o sistema desejado

Exemplo:

pip install -r whatsappbot/requirements.txt

Evite instalar dependências globais para todos os sistemas ao mesmo tempo. Os scripts têm finalidades diferentes e algumas bibliotecas exigem permissões específicas do sistema operacional.

Execução

Busca Automática Google

cd busca_automatica_google
python3 busca_google.py

Antes de executar, revise no script:

  • palavras-chave;
  • link alvo;
  • quantidade de páginas;
  • comportamento de proxy/navegação.

Instagram Bot

cd instagrambot
python3 instagrambot.py

Outros scripts disponíveis:

python3 instagram_curtir_fotos.py
python3 instagrambot_baixa_seguidores.py
python3 instagrambot_segue_following.py
python3 instagrambot_seguidores_lista_excel_mais_que_1_comentario.py

WhatsApp Bot

cd whatsappbot
python3 whatsappbot.py

Outros scripts disponíveis:

python3 whatsappbot-listadecontatos.py
python3 whasappbot-listadecontato-EXCEL.py

WppMessage

Envio para um número:

cd wppmessage/versao1_0_single_number
python3 wppmessage.py

Envio para múltiplos números:

cd wppmessage/versao1_1_multiple_numbers
python3 wppmessage.py

Boas práticas para manter este repositório

  • Mantenha cada sistema com seu próprio requirements.txt.
  • Evite credenciais, tokens e caminhos pessoais fixos nos scripts.
  • Antes de rodar automações de mensagem, revise contatos, textos e horários.
  • Scripts com Selenium dependem da estrutura atual da página; mudanças no Google, Instagram ou WhatsApp Web podem exigir atualização de seletores.
  • No macOS, automações com keyboard podem exigir permissões de acessibilidade.
  • Se um sistema crescer, crie subpastas internas como src/, data/, assets/ e docs/ apenas dentro daquele sistema.

Autor

Flávio Oliveira