About telegram-vagas-gupy-bot

Automação em Python que consome a API secreta da Gupy, filtra vagas no estado do Rio de Janeiro e dispara alertas formatados em tempo real no Telegram.

l

Published by

lucasnunestrabalho99-sudo

Visit View Profile

README.md

View on GitHub

🚀 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

telegram-vagas-gupy-bot