Caçador Da Chapeuzinho Vermelho

O que é o caçador da chapeuzinho vermelho

O caçador da chapeuzinho vermelho é um script de monitoramento de trackers Torrent que você sobe na sua própria VPS e deixa rodando em segundo plano. Ele consulta periodicamente os sites que você configurar, procura por novos lançamentos correspondentes a uma palavra-chave e te avisa assim que algo aparece. A maioria das pessoas que usa isso roda no Brasil porque o público fomenta o uso de trackers nacionais e internacionais como T411, PassThePopcorn, KeepFriends e outros trackers fechados. Aqui vou mostrar como colocar para funcionar, que armadilha eu levei e resolvi, e onde esse tipo de solução começa a falhar pra você não ter ilusão. O script se loga num tracker, faz uma busca e verifica o que tem de novo desde a última execução. Se achou algo, guarda o link, o tamanho, o nome e manda o alert. O alert pode ir por qualquer coisa que tenha webhook: Telegram, Discord, e-mail, até um simple curl pro seu proprio bot. A parte que todo mundo estraga é a frequência de polling. Rodar a cada minuto em tracker grande quebra a conta ou pelo menos te coloca numa fila de espera que faz o script nunca encontrar nada antes do proximo cycle.

Eu recomendo usar um fork atualizado do projeto original. O repo que mais se mantém é o caçador da chapeuzinho vermelho feito pelo t411noob, que tem suporte a vários trackers e webhook pronto pro Telegram. Clona ele direto na VPS. Cria um diretorio separado pro servico e baixa as dependencias dentro de um virtualenv. Isso evita confusao com pacotes do sistema. O install pede só Python mesmo, sem Rust, sem compilacao pesada. Depois voce copia o arquivo de configuracao exemplo, renomeia pro nome que o script espera e preenche os campos. Coloca o token do Telegram, as URLs de login, as search URLs e o que voce quer monitorar. Cada tracker tem um jeito proprio. O T411 usa parametros via GET com categoria e ordem. KeepFriends pede post no endpoint especifico com formulario. Se o tracker não tiver search API publica, o script tenta parsear a pagina, o que quebra mais rapido quando o layout muda.

Testa com um termo pequeno antes de soltar o watchdog. Roda o script uma vez no terminal com debug ligado. Se logar e retornar resultados, ta bom. Se der erro de sessao, verifica se os cookies estão sendo persistidos entre execucoes. Isso aqui é o erro mais comun: o script roda, loga, acha, mas na proxima vez não reconecta porque o cookie expires ou o tracker muda o nome do campo de sessao.

Configuracao minima que funcionou pra mim

Meu arquivo ficou assim: tracker t411, busca por nome solto com campo de categoria, intervalo de 15 minutos, alerta pros canais que eu defini. A parte que eu mudei foi o delay entre requisicoes. Coloquei 4 segundos entre cada chamada. Sem isso, o T411 te dá ban temporario por request spam. Nao é brincadeira. Eu levei três dias pra entender que era isso porque o tracker nao avisa nada, so para responder. Outro ajuste foi o retry. Deixa o script tentar duas vezes com backoff quando o tracker responder 503. A maioria dos trackers grandes entra em load balancing em horários de pico e cai de vez em quando. Se voce tratar isso como erro critico, o servico para e voce só descobre no dia seguinte.

Como deixar rodando sozinho

Coloca um systemd service. Eu uso um service que roda com usuario normal, sem sudo, e reinicia automaticamente se cair. Configurei para manter no journalctl e limitacao de memoria bem simples. Sem necessidade de supervisord ou docker se o proposito é só monitorar. A variavel de ambiente necessaria é so o token do Telegram. Se for usar Discord tambem, adiciona o webhook URL. O script permite multiplos destinos no mesmo arquivo de config.

O que eu aprendi na marra

A primeira vez que configurei, deixei o polling em 30 segundos no PassThePopcorn. Em duas horas, minha conta foi colocada num timeout de ip. A solucao foi aumentar pra 3 minutos e adicionar um randomizador de delay entre 60 e 120 segundos. Funciona melhor porque simula comportamento humano e evita padrao fixo que firewalls simples batem facil. Tambem descobri que tracker com anti hotlink e verificação de referrer quebra o download via script. Nao adianta receber o alert se o link cai quando voce clica. Nesses casos, o jeito é abrir o magnet link direto pelo cliente torrent que voce já tem configurado. Eu resolvi enviando só o hash no alert e usando um client local que escuta magnet links via api, como o qbittorrent ou transmission com acesso remoto habilitado.

Limitacoes reais

Esse metodo nao funciona bem para trackers que exigem CAPTCHA no login. Se o tracker pede desafio todo mes, o script trava. Você tem que entrar manualmente, renovar a sessao e reconfigurar os cookies. Tracker semi-fechado que muda layout todo trimestre também quebra a parseacao. Aí voce passa horas ajustando seletores CSS e ainda assim pode falhar num update do site. Outro ponto: a precisao depende da qualidade da busca. Search vaga pega spam. Search com aspas exatas pega só o que é igual. Se voce monitora nome de serie ou filme, usa o padrao de nome completo mais ano. Se monitora lançamento de jogo, adiciona palavras como RePack ou FitGirl, senao a pagina volta centenas de itens irrelevantes e o alert vira ruido.

Alternativas

Se voce so quer receber notificacao e não se importa em rodar codigo proprio, existem servicos pagos que fazem o mesmo monitoramento sem manutenção. Mas isso custa dinheiro e voce nao controla a precisao. Se o tracker que voce quer monitorar tem rss feed habilitado, usa o próprio rss. É mais estável, nao precisa de sessao em varios lugares, e ate o qbittorrent lê rss nativamente. A desvantagem é que nao todos os trackers oferecem rss com a granularidade que voce quer. A estrutura basica é: nome do tracker, url de login, usuario, senha, url de busca, termos, intervalo, webhook. Tudo em yaml ou json. Eu prefiro yaml porque é mais legivel pra editar rápido. Exemplo concreto: tracker t411, busca "John.Woods.S01", intervalo 900 segundos, delay 4 segundos, webhook telegram com chat id proprio. Quando voce salvar, roda o teste e checa o log. Se vier message de sucesso e o bot mandar a notifikacao, tá pronto.

Manutencao pos-instalacao

Verifica o log semanalmente. Se o numero de hits cair de repente, o tracker pode ter mudado a pagina de busca. Abre o console do navegador, copia a requisição da busca e compara com a que o script monta. A diferenca costuma estar no nome do parametro de search ou na ordem de classificação. Atualiza o repositorio a cada dois meses. Os forks mais ativos recebem fix de segurança e suporte a novos trackers. Se voce travar numa versao antiga, vai perder funcionalidades sem perceber.

Download

O repositorio disponivel e amplamente usado e mantido por contribuidores brasileiros é o caçador da chapeuzinho vermelho no GitHub do usuario t411noob. O link direto é github.com/t411noob/caçador-da-chapeuzinho-vermelho. Baixe a ultima release, nao o branch principal, porque a release tem o build testado. A branch main pode ter feature experimental que quebra o webhook.

Resumo pratico

Rodar o caçador da chapeuzinho vermelho e simples se voce tratar como ferramenta operativa, não como solução mgica. Ele entrega alertas rapidos, mas exige sessao valida, delay respeitoso, retry inteligente e manutencao periodica. Se voce nao quiser cuidar disso, usa rss ou servico pago. Se quiser controle total e saber exatamente o que chega, keep a VPS rodando, configura o systemd e testa antes de confiar no piloto automatico.