🤖 LinkedIn Auto Connect Bot

Automação desenvolvida em Python utilizando PyAutoGUI para localizar o botão "Conectar" na tela e realizar interações automáticas por meio de reconhecimento de imagem.

⚠️ Aviso Importante

Este projeto foi desenvolvido para fins de estudo e aprendizado em automação de interface gráfica (GUI Automation) utilizando Python.

O uso de automações em plataformas de terceiros pode violar seus Termos de Uso. Utilize este projeto apenas em ambientes de teste, aplicações próprias ou quando possuir autorização para automatizar a interface.

---

📑 Índice

• ✨ Funcionalidades
• 🛠️ Tecnologias
• 📁 Estrutura do Projeto
• ⚙️ Requisitos
• 🚀 Instalação
• ▶️ Como Executar
• 🖼️ Captura da Imagem
• 📍 Captura de Coordenadas
• ⚙️ Configuração
• 📋 Fluxo de Funcionamento
• ❗ Possíveis Problemas
• 📄 Licença

---

✨ Funcionalidades

• ✅ Abre automaticamente o Google Chrome
• ✅ Acessa uma página pré-definida
• ✅ Localiza um botão através de reconhecimento de imagem
• ✅ Realiza rolagem automática da página
• ✅ Clica automaticamente no botão encontrado
• ✅ Conta quantas ações foram realizadas
• ✅ Fecha o navegador ao finalizar
• ✅ Interrompe automaticamente caso o botão não seja localizado
• ✅ Tratamento básico de exceções

---

🛠️ Tecnologias

• Python 3
• PyAutoGUI
• OpenCV
• Pillow

---

📁 Estrutura do Projeto

LinkedIn-AutoConnect/
│
├── app.py
├── capturar-posicao.py
├── botao-conectar.png
├── requirements.txt
├── README.md
└── _config.yml

---

⚙️ Requisitos

• Python 3.10 ou superior
• Google Chrome instalado
• Resolução de tela compatível com a imagem utilizada
• Windows

---

🚀 Instalação

Clone o repositório:

git clone https://github.com/sergiocalazans/linkedin-autoconnect-bot.git

Entre na pasta:

cd linkedin-autoconnect-bot

Crie um ambiente virtual:

Windows

python -m venv .venv

Ative o ambiente:

.venv\Scripts\activate

Instale as dependências:

pip install -r requirements.txt

---

▶️ Como Executar

Execute:

python app.py

O programa irá:

1. Abrir o Google Chrome
2. Acessar a página configurada
3. Posicionar a barra de rolagem
4. Procurar pela imagem botao-conectar.png
5. Clicar quando encontrada
6. Repetir o processo até atingir o número configurado

---

🖼️ Captura da Imagem

O reconhecimento é realizado através do arquivo:

botao-conectar.png

Para obter melhores resultados:

• utilize zoom do navegador em 100%
• utilize a mesma resolução da captura
• recorte somente o botão
• evite sombras e áreas extras
• utilize o mesmo tema (claro ou escuro)

Quanto mais limpa for a imagem, maior será a precisão do reconhecimento.

---

📍 Captura de Coordenadas

O projeto possui um script auxiliar:

capturar-posicao.py

Ele pode ser utilizado para descobrir as coordenadas do mouse.

Exemplo de saída:

X: 1358
Y: 160

Essas coordenadas podem ser utilizadas para alterar esta linha do código:

pyautogui.click(x=1358, y=160)

---

⚙️ Configuração

No arquivo app.py é possível alterar:

Quantidade de ações

convites = 60

---

Tempo de espera

sleep(5)

---

Pausa entre comandos

pyautogui.PAUSE = 0.5

---

Sensibilidade da imagem

confidence=0.8

Valores menores encontram mais imagens, porém aumentam a chance de falsos positivos.

---

📋 Fluxo de Funcionamento

Início
   │
   ▼
Abrir Chrome
   │
   ▼
Acessar página
   │
   ▼
Posicionar Scroll
   │
   ▼
Procurar imagem
   │
   ├── Encontrou
   │      │
   │      ▼
   │   Clicar
   │      │
   │      ▼
   │   Incrementar contador
   │      │
   │      ▼
   │   Próxima tentativa
   │
   └── Não encontrou
          │
          ▼
     Encerrar processo

---

❗ Possíveis Problemas

O botão não é encontrado

Verifique:

• Zoom do navegador
• Resolução da tela
• Escala do Windows
• Tema claro/escuro
• Qualidade da imagem

---

O scroll não funciona

Verifique se:

• a página possui foco;
• a barra lateral está ativa;
• a janela do navegador está maximizada.

---

Erro com confidence

Instale o OpenCV:

pip install opencv-python

---

Erro ao abrir o navegador

Verifique se o Chrome está instalado e acessível pelo menu Iniciar.

---

📄 Licença

Este projeto é disponibilizado exclusivamente para fins educacionais e de estudo sobre automação de interfaces gráficas utilizando Python.

O autor não incentiva nem se responsabiliza pelo uso deste código em desacordo com os Termos de Serviço de plataformas de terceiros.

---

Desenvolvido por: Sérgio Calazans