GetBlocked!

Páginas mais limpas. Menos rastreadores. Apenas local.

O GetBlocked! é uma extensão leve e apenas local para Chrome que ajuda a reduzir o rastreamento comum de terceiros em sites, bloqueando pedidos de rastreadores conhecidos, limpando ligações de rastreamento e explicando tentativas de rastreamento.

Foi construído como um pequeno projeto Manifest V3 inspecionável para pessoas que desejam uma ferramenta de privacidade amigável e para contribuidores que desejam pull requests rápidas e úteis.

O que o GetBlocked! Faz

• Bloqueia uma lista inicial curada de domínios de rastreadores de terceiros conhecidos usando o Chrome declarativeNetRequest.
• Limpa parâmetros comuns de URL de rastreamento como utm_source, fbclid, gclid, dclid, mc_cid e IDs de campanha semelhantes.
• Deteta tentativas visíveis de rastreamento como pixels, scripts suspeitos, iframes de rastreamento e ligações de rastreamento.
• Mostra um relatório compacto no popup com:
  • Bloqueados nesta página
  • Ligações de rastreamento limpas
  • Tentativas visíveis de rastreamento detetadas
  • Categorias detetadas
• Mantém os dados do relatório localmente em chrome.storage.local.

O que o GetBlocked! Pode Bloquear

O GetBlocked! bloqueia uma lista inicial curada de domínios de rastreadores de terceiros conhecidos e parâmetros de URL de rastreamento.

A cobertura atual inclui:

• Rastreadores de análise
• Rastreadores de anúncios e reorientação
• Pixels de redes sociais
• Ferramentas de repetição de sessão e mapas de calor
• Rastreadores de afiliados e atribuição
• Rastreadores de marketing por email
• Parâmetros de URL de rastreamento

A lista de rastreadores é intencionalmente conservadora. As regras são limitadas a pedidos de terceiros para reduzir quebras de sites.

O que o GetBlocked! Não Pode Fazer

• Não bloqueia todos os rastreadores.
• Não torna os utilizadores anónimos.
• Não para o rastreamento após iniciar sessão numa conta.
• Não para o rastreamento do lado do servidor.
• Não impede completamente a impressão digital avançada.
• Não se destina a substituir bloqueadores de anúncios completos.

Como o GetBlocked! É Diferente

O GetBlocked! é:

• Leve: conjunto de regras pequeno, popup simples, partes móveis mínimas.
• Apenas local: sem análise externa, telemetria ou registo remoto.
• Código aberto: as regras, popup e scripts de geração são inspecionáveis.
• Educativo: as categorias e a redação são projetadas para explicar o rastreamento comum de forma clara.
• Amigável para iniciantes: pequenos PRs podem melhorar o catálogo de rastreadores, documentação, testes ou interface.
• Não substitui bloqueadores de anúncios completos: foca-se em rastreadores comuns e explicações claras.

Porque é que Todos os Dados Permanecem Locais

O GetBlocked! não envia dados de navegação para nenhum servidor. A extensão usa:

• declarativeNetRequest para bloqueio de pedidos gerido localmente pelo Chrome.
• chrome.storage.local para dados de relatório de página.
• Um script de conteúdo que analisa localmente a página atual em busca de sinais visíveis de rastreamento.

Não há análise externa, endpoints de telemetria, registos remotos ou ativos remotos empacotados na extensão.

Instalar Localmente no Chrome

1. Descarregue ou clone este repositório.
2. Abra chrome://extensions.
3. Ative o modo de programador.
4. Escolha Carregar descompactada.
5. Selecione a pasta do projeto GetBlocked!.
6. Afixe o GetBlocked! e abra o popup em páginas web normais.

A versão de produção evita permissões de feedback DNR apenas para depuração. O popup utiliza sinais locais da página mais o distintivo de contagem de ações DNR de produção do Chrome como uma estimativa ao nível da página, enquanto as regras de bloqueio e limpeza de URL permanecem aplicadas pelo MV3 declarativeNetRequest.

Contribuir em 10 Minutos

A forma mais fácil de contribuir é adicionar um domínio de rastreador.

1. Edite shared/tracker-catalog.json.
2. Adicione um fixture em test/tracker-test-set.json.
3. Execute npm run generate:rules.
4. Execute npm run test:evidence.
5. Abra um PR.

PRs são bem-vindos para adições de domínios de rastreadores, testes de sites quebrados, polimento da interface, documentação e melhorias nos testes. Não precisa de perguntar antes de abrir um PR pequeno e focado.

Como Funciona o Catálogo de Rastreadores

Os domínios de rastreadores são mantidos em shared/tracker-catalog.json.

Cada entrada de rastreador inclui:

• domain
• category
• label
• notes

Os parâmetros de URL de rastreamento são mantidos em shared/tracking-params.json.

Após alterar o catálogo ou a lista de parâmetros de rastreamento, regenera os ficheiros derivados da extensão:

npm run generate:rules

Isto atualiza:

• rules/rules.json, usado pelo Chrome declarativeNetRequest.
• shared/config.js, usado pelo script de conteúdo e pela deteção de categorias do popup.

Não edite as regras/configuração geradas manualmente, a menos que também atualize o gerador ou o catálogo de origem.

Executar Testes

Execute as mesmas camadas de validação local que o CI usa:

npm run check

Isto regenera as regras, executa o fixture de evidência, verifica a sintaxe JavaScript, analisa os ficheiros de dados JSON, verifica se os ficheiros gerados estão sincronizados e executa as proteções de privacidade/segurança.

Verificações individuais úteis:

npm run generate:rules
npm run test:evidence
npm run check:syntax
npm run check:json
npm run check:generated
npm run check:safety

Verificação Manual no Navegador

Após carregar a extensão descompactada, inicie um servidor local simples a partir desta pasta:

python -m http.server 8080

Depois abra:

http://localhost:8080/test/manual-test.html?utm_source=demo&utm_medium=test&fbclid=manual

Com o GetBlocked! ativado, os parâmetros de rastreamento devem ser removidos do URL da página e o popup deve mostrar a atividade de rastreadores ao nível da página. Para uma verificação antes/depois, compare o painel de Rede do navegador com a extensão desativada e depois ativada.

Ligações para Contribuidores

• Guia de contribuição
• Adicionar rastreadores
• Sites quebrados
• Guia de desenvolvimento
• Boas primeiras issues
• Guia de etiquetas
• Texto de lançamento
• Política de segurança

Licença

Licença MIT. Consulte LICENSE.