← projetos

projeto

Mão Dupla — Extensão Chrome para Gerenciar Seguidores no Instagram

em Projeto pessoal

Mão Dupla — Extensão Chrome para Gerenciar Seguidores no Instagram

Uma extensão open source que mostra quem não te segue de volta e acompanha o que mudou entre uma atualização e outra.

O que é

Extensão para Chrome (Manifest V3), que também funciona em Edge e Brave. A partir da conta do próprio usuário no Instagram, mostra quem ele segue e não é seguido de volta, quem deixou de seguir, quem chegou e quem saiu do "seguindo". Permite seguir e deixar de seguir direto da lista, um a um ou em fila. Projeto open source (licença MIT), com a versão 2.0.0 publicada e o instalador em .zip na página de Releases.

Como funciona

A extensão injeta funções na aba do Instagram em que o usuário já está logado, via chrome.scripting, e consome a API interna do site imitando as requisições dele. Tudo roda localmente no navegador: não há servidor, não pede senha e não envia dados para ninguém. As listas ficam em cache local e cada atualização é comparada com a anterior, o que permite mostrar as mudanças ao longo do tempo.

Funcionalidades

  • Carregamento das listas em tempo real, com barra de progresso, e comparação de cada atualização com a anterior.
  • Conferência direta no Instagram dos alertas de "saiu", antes de mostrá-los, para evitar falsos positivos.
  • Fila de follow e de unfollow com pausa aleatória entre as ações. A fila para sozinha e trava por 6 horas se o Instagram limitar a conta.
  • Exportação e importação de tudo em .zip (JSON completo mais um CSV por aba), para levar os dados de um computador para outro.
  • Interface própria: barra lateral, cards com foto e selo de verificado, busca e paginação configurável.
  • Acessibilidade: foco visível por teclado, rótulos para leitores de tela e suporte a "reduzir movimento".

Stack técnica

  • JavaScript puro, sem dependências nem build
  • Chrome Extensions (Manifest V3) e chrome.scripting
  • localStorage para o cache local
  • GitHub Actions para o release automatizado

Destaques técnicos

  • Escrevi do zero o gerador e o leitor de .zip, incluindo o cálculo de CRC32, sem usar bibliotecas
  • Reaproveitamento da sessão já aberta no navegador, sem guardar cookies, tokens ou senhas
  • Validação dos dados na importação, descartando links de foto que não sejam do Instagram
  • Verificação de cada alerta suspeito direto no Instagram para eliminar falsos positivos
  • Fila com pausa aleatória e trava automática quando o Instagram limita a conta
  • Release automático: ao criar uma tag, o workflow confere a versão do manifesto, empacota o zip e publica a release

Como foi feito

Desenvolvido por mim com o auxílio do Claude AI, que me ajudou a investigar o funcionamento do site, escrever e testar o código.

Este site usa cookies essenciais (tema, preferências) e, com sua permissão, cookies de análise (Google Analytics) para entender como o site é usado. saiba mais