GetBlocked!

Sauberere Seiten. Weniger Tracker. Nur lokal.

GetBlocked! ist eine leichte, nur lokal arbeitende Chrome-Erweiterung, die hilft, gängiges Third-Party-Tracking zu reduzieren, indem sie bekannte Tracker-Anfragen blockiert, Tracking-Links bereinigt und Tracking-Versuche erklärt.

Es ist als kleines, überprüfbares Manifest-V3-Projekt entwickelt – sowohl für Leute, die ein freundliches Datenschutz-Tool suchen, als auch für Mitwirkende, die schnelle, nützliche Pull-Requests einreichen möchten.

Was GetBlocked! tut

• Blockiert eine kuratierte Startliste bekannter Third-Party-Tracker-Domains mit Chrome declarativeNetRequest.
• Bereinigt gängige Tracking-URL-Parameter wie utm_source, fbclid, gclid, dclid, mc_cid und ähnliche Kampagnen-IDs.
• Erkennt sichtbare Tracking-Versuche wie Pixel, verdächtige Skripte, Tracking-Iframes und Tracking-Links.
• Zeigt einen kompakten Popup-Bericht mit:
  • Auf dieser Seite blockiert
  • Tracking-Links bereinigt
  • Sichtbare Tracking-Versuche erkannt
  • Erkannte Kategorien
• Speichert Berichtsdaten lokal in chrome.storage.local.

Was GetBlocked! blockieren kann

GetBlocked! blockiert eine kuratierte Startliste bekannter Third-Party-Tracker-Domains und Tracking-URL-Parameter.

Die aktuelle Abdeckung umfasst:

• Analyse-Tracker
• Werbe- und Retargeting-Tracker
• Social-Media-Pixel
• Session-Replay- und Heatmap-Tools
• Affiliate- und Attributions-Tracker
• E-Mail-Marketing-Tracker
• Tracking-URL-Parameter

Die Tracker-Liste ist bewusst konservativ gehalten. Die Regeln beschränken sich auf Third-Party-Anfragen, um Seitenstörungen zu reduzieren.

Was GetBlocked! nicht kann

• Es blockiert nicht jeden Tracker.
• Es macht Benutzer nicht anonym.
• Es stoppt kein Tracking nach dem Einloggen in ein Konto.
• Es stoppt kein serverseitiges Tracking.
• Es verhindert erweitertes Fingerprinting nicht vollständig.
• Es ist kein Ersatz für vollwertige Werbeblocker.

Wie GetBlocked! anders ist

GetBlocked! ist:

• Leicht: kleiner Regelsatz, einfaches Popup, minimale bewegliche Teile.
• Nur lokal: keine externen Analysen, Telemetrie oder Fernprotokollierung.
• Open Source: Regeln, Popup und Generierungsskripte sind überprüfbar.
• Lehrreich: Kategorien und Wortlaut sind darauf ausgelegt, gängiges Tracking klar zu erklären.
• Anfängerfreundlich: kleine PRs können den Tracker-Katalog, die Dokumentation, Tests oder die Benutzeroberfläche verbessern.
• Kein Ersatz für vollwertige Werbeblocker: Es konzentriert sich auf gängige Tracker und klare Erklärungen.

Warum alle Daten lokal bleiben

GetBlocked! sendet keine Browserdaten an einen Server. Die Erweiterung verwendet:

• declarativeNetRequest für lokale, von Chrome verwaltete Anfrageblockierung.
• chrome.storage.local für Seitenberichtsdaten.
• Ein Content-Skript, das die aktuelle Seite lokal auf sichtbare Tracking-Signale durchsucht.

Es gibt keine externen Analysen, Telemetrie-Endpunkte, Fernprotokolle oder eingebettete entfernte Ressourcen in der Erweiterung.

Lokal in Chrome installieren

1. Dieses Repository herunterladen oder klonen.
2. chrome://extensions öffnen.
3. Entwicklermodus einschalten.
4. "Entpackte Erweiterung laden" wählen.
5. Den GetBlocked!-Projektordner auswählen.
6. GetBlocked! anheften und das Popup auf normalen Webseiten öffnen.

Der Produktionsbuild verzichtet auf Debug-only-DNR-Feedback-Berechtigungen. Das Popup verwendet lokale Seitensignale plus Chrome's Produktions-DNR-Action-Count-Badge als seitenweite Schätzung, während Blockierungs- und URL-Bereinigungsregeln weiterhin durch MV3 declarativeNetRequest durchgesetzt werden.

In 10 Minuten mitwirken

Der einfachste Weg beizutragen ist, eine Tracker-Domain hinzuzufügen.

1. shared/tracker-catalog.json bearbeiten.
2. Einen Eintrag in test/tracker-test-set.json hinzufügen.
3. npm run generate:rules ausführen.
4. npm run test:evidence ausführen.
5. Einen PR öffnen.

PRs sind willkommen für Tracker-Domain-Ergänzungen, Tests für defekte Seiten, UI-Verbesserungen, Dokumentation und Testverbesserungen. Du musst nicht vorher fragen, bevor du einen kleinen, fokussierten PR öffnest.

Wie der Tracker-Katalog funktioniert

Tracker-Domains werden in shared/tracker-catalog.json verwaltet.

Jeder Tracker-Eintrag enthält:

• domain
• category
• label
• notes

Tracking-URL-Parameter werden in shared/tracking-params.json verwaltet.

Nach Änderungen am Katalog oder der Tracking-Parameter-Liste die abgeleiteten Erweiterungsdateien neu generieren:

npm run generate:rules

Dies aktualisiert:

• rules/rules.json, verwendet von Chrome declarativeNetRequest.
• shared/config.js, verwendet vom Content-Skript und der Popup-Kategorieerkennung.

Generierte Regeln/Konfigurationen nicht von Hand bearbeiten, es sei denn, du aktualisierst auch den Generator oder den Quellkatalog.

Tests ausführen

Führe dieselben lokalen Validierungsebenen aus, die auch CI verwendet:

npm run check

Dies generiert Regeln neu, führt die Evidenz-Testfälle aus, prüft die JavaScript-Syntax, analysiert JSON-Datendateien, überprüft die Synchronisation der generierten Dateien und führt die Datenschutz-/Sicherheits-Schutzmaßnahmen durch.

Nützliche Einzelprüfungen:

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

Manuelle Browser-Überprüfung

Nach dem Laden der entpackten Erweiterung einen einfachen lokalen Server aus diesem Ordner starten:

python -m http.server 8080

Dann öffnen:

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

Wenn GetBlocked! aktiviert ist, sollten die Tracking-Parameter aus der Seiten-URL entfernt werden und das Popup sollte seitenweite Tracker-Aktivität anzeigen. Für einen Vorher/Nachher-Vergleich das Netzwerk-Panel des Browsers bei deaktivierter und dann aktivierter Erweiterung vergleichen.

Mitwirkungs-Links

• Mitwirkungsleitfaden
• Tracker hinzufügen
• Defekte Seiten
• Entwicklungsleitfaden
• Gute erste Aufgaben
• Label-Leitfaden
• Starttext
• Sicherheitsrichtlinie

Lizenz

MIT-Lizenz. Siehe LICENSE.