🚀 Gupy Job Tracker: Automação de Vagas (RJ & Home Office) no Telegram
📖 Sobre o Projeto
Buscar vagas de emprego diariamente é um processo exaustivo e repetitivo. Para resolver esse problema, desenvolvi este rpa em Python.
O robô atua como um "radar" silencioso: ele monitora a plataforma Gupy, captura novas oportunidades de trabalho no Estado do Rio de Janeiro e vagas 100% Home Office, e dispara alertas formatados em tempo real diretamente em um canal do Telegram. Assim, as vagas chegam mastigadas até os candidatos.
🎯 Veja rodando na prática
Quer ver o robô trabalhando ao vivo? Entre no grupo aberto do Telegram que é alimentado 100% por esta automação: 👉 Entrar no Grupo: Vagas Gupy | Rio de Janeiro
📸 Demonstração do Bot
Acima: Interface do bot entregando vagas no grupo com formatação amigável.
💡 Diferenciais Técnicos (Por que não usei Selenium?)
A maioria das automações de Web Scraping utiliza ferramentas que simulam um navegador aberto (como Selenium), o que consome muita memória RAM e deixa o processo lento. Este projeto resolve o problema usando uma abordagem API-First:
- Performance Extrema: O script intercepta a API oculta que a própria Gupy usa para renderizar as vagas. Ele consome pacotes JSON puros, sendo incrivelmente mais rápido e leve.
- Tratamento de Dados: A API retorna datas no fuso horário global (UTC) e termos técnicos em inglês. O código faz o parse automático, traduzindo para o horário de Brasília e para o português.
- Trava Anti-Spam (SQLite): Utiliza um banco de dados relacional leve (
vagas_gupy.db) para memorizar o ID de cada vaga processada. Isso garante que o bot nunca envie a mesma vaga duplicada para o grupo, mesmo que o script seja reiniciado.
⚙️ Como Adaptar para o SEU Estado / Filtro
O código foi criado para buscar RJ e Home Office, mas você pode mudar para qualquer estado ou adicionar novas buscas.
Abra o arquivo main.py, vá até a função buscar_vagas_gupy() e modifique a lista filtros_de_busca:
# Adicione ou altere os dicionários da lista abaixo
filtros_de_busca = [
{"nome": "SÃO PAULO", "params": {'state': 'São Paulo', 'limit': 10}},
{"nome": "HOME OFFICE", "params": {'workplaceTypes': 'remote', 'limit': 10}}
]
🚀 Instalação e Uso Local
1. Pré-requisitos
- Python 3.8+ instalado.
- Um Bot criado no Telegram via @BotFather.
2. Clonando o Repositório
Abra o terminal e rode os comandos:
git clone [https://github.com/lucasnunestrabalho99-sudo/telegram-vagas-gupy-bot.git](https://github.com/lucasnunestrabalho99-sudo/telegram-vagas-gupy-bot.git)
cd telegram-vagas-gupy-bot
3. Configurando o Ambiente
Crie um ambiente virtual e instale as bibliotecas necessárias:
python -m venv venv
# No Windows:
venv\Scripts\activate
# No Linux/Mac:
source venv/bin/activate
pip install -r requirements.txt
4. Variáveis de Ambiente
Crie um arquivo chamado exatamente .env na raiz do projeto e insira as credenciais do seu robô e do seu grupo:
TELEGRAM_TOKEN=cole_seu_token_aqui
CHAT_ID_GRUPO=cole_o_id_do_seu_grupo_aqui
5. Executando o Motor
python main.py
📅 Agendamento Automático (Windows)
Se você utiliza Windows, o repositório inclui um arquivo rodar_gupy.bat. Você pode usar o Agendador de Tarefas do Windows para rodar esse arquivo de hora em hora. O .bat já está configurado para forçar o encoding UTF-8 (evitando crash com emojis) e gerar um arquivo erro_log.txt para monitoramento.
Desenvolvido com ☕ por Lucas Nunes | LinkedIn