GetBlocked!

よりクリーンなページ。トラッカーを削減。ローカルオンリー。

GetBlocked! は、軽量でローカルオンリーのChrome拡張機能です。既知のトラッカーリクエストをブロックし、トラッキングリンクをクリーンにし、トラッキングの試みを説明することで、一般的なサードパーティのウェブサイトトラッキングを削減します。

フレンドリーなプライバシーツールを求めるユーザーと、素早く有用なプルリクエストをしたいコントリビューターのために、小さくて検査可能なManifest V3プロジェクトとして構築されています。

GetBlocked! の機能

• ChromeのdeclarativeNetRequestを使用して、厳選された既知のサードパーティトラッカードメインのスターターリストをブロックします。
• utm_source、fbclid、gclid、dclid、mc_cidなどの一般的なトラッキングURLパラメータや、同様のキャンペーンIDをクリーンにします。
• ピクセル、不審なスクリプト、トラッキングiframe、トラッキングリンクなど、目に見えるトラッキングの試みを検出します。
• コンパクトなポップアップレポートを表示します：
  • このページでブロックされたもの
  • クリーンにされたトラッキングリンク
  • 検出された目に見えるトラッキングの試み
  • 検出されたカテゴリ
• レポートデータをchrome.storage.localにローカル保持します。

GetBlocked! がブロックできるもの

GetBlocked! は、厳選された既知のサードパーティトラッカードメインとトラッキングURLパラメータのスターターリストをブロックします。

現在の対応範囲：

• アナリティクストラッカー
• 広告およびリターゲティングトラッカー
• ソーシャルメディアピクセル
• セッションリプレイおよびヒートマップツール
• アフィリエイトおよびアトリビューショントラッカー
• メールマーケティングトラッカー
• トラッキングURLパラメータ

トラッカーリストは意図的に控えめです。ルールはサードパーティリクエストに限定され、サイトの破損を軽減します。

GetBlocked! ができないこと

• すべてのトラッカーをブロックするわけではありません。
• ユーザーを匿名にするわけではありません。
• アカウントにログインした後のトラッキングを止めるわけではありません。
• サーバーサイドのトラッキングを止めるわけではありません。
• 高度なフィンガープリンティングを完全に防ぐわけではありません。
• フル機能の広告ブロッカーの代わりになるものではありません。

GetBlocked! の違い

GetBlocked! は：

• 軽量：小さなルールセット、シンプルなポップアップ、最小限の可動部品。
• ローカルオンリー：外部分析、テレメトリー、リモートログはありません。
• オープンソース：ルール、ポップアップ、生成スクリプトは検査可能。
• 教育的：カテゴリと表現は、一般的なトラッキングを明確に説明するように設計されています。
• 初心者に優しい：小さなPRでトラッカーカタログ、ドキュメント、テスト、UIを改善できます。
• フル機能の広告ブロッカーの代替ではありません：一般的なトラッカーと明確な説明に焦点を当てています。

すべてのデータがローカルに留まる理由

GetBlocked! はブラウジングデータをサーバーに送信しません。拡張機能は以下を使用します：

• ローカルのChrome管理リクエストブロッキングのためのdeclarativeNetRequest。
• ページレポートデータのためのchrome.storage.local。
• 現在のページをローカルでスキャンして、目に見えるトラッキングシグナルを検出するコンテンツスクリプト。

拡張機能には、外部分析、テレメトリーエンドポイント、リモートログ、またはバンドルされたリモートアセットはありません。

Chromeにローカルインストール

1. このリポジトリをダウンロードまたはクローンします。
2. chrome://extensions を開きます。
3. デベロッパーモードをオンにします。
4. 「パッケージ化されていない拡張機能を読み込む」を選択します。
5. GetBlocked! プロジェクトフォルダを選択します。
6. GetBlocked! をピン留めし、通常のWebページでポップアップを開きます。

プロダクションビルドは、デバッグ専用のDNRフィードバック権限を避けます。ポップアップは、ローカルページシグナルとChromeのプロダクションDNRアクションカウントバッジをページレベルの推定値として使用し、ブロックとURLクリーンルールはMV3のdeclarativeNetRequestによって引き続き適用されます。

10分で貢献

最も簡単な貢献方法は、1つのトラッカードメインを追加することです。

1. shared/tracker-catalog.jsonを編集します。
2. test/tracker-test-set.jsonに1つのフィクスチャを追加します。
3. npm run generate:rules を実行します。
4. npm run test:evidence を実行します。
5. PRを開きます。

トラッカードメインの追加、壊れたサイトのテスト、UIの洗練、ドキュメント、テストの改善に関するPRを歓迎します。小さく焦点を絞ったPRを開く前に尋ねる必要はありません。

トラッカーカタログの仕組み

トラッカードメインは、shared/tracker-catalog.jsonで管理されています。

各トラッカーエントリには以下が含まれます：

• domain (ドメイン)
• category (カテゴリ)
• label (ラベル)
• notes (備考)

トラッキングURLパラメータは、shared/tracking-params.jsonで管理されています。

カタログまたはトラッキングパラメータリストを変更した後、派生した拡張機能ファイルを再生成します：

npm run generate:rules

これにより以下が更新されます：

• rules/rules.json（ChromeのdeclarativeNetRequestで使用）
• shared/config.js（コンテンツスクリプトとポップアップのカテゴリ検出で使用）

生成されたルール/設定を手動で編集しないでください。ジェネレーターまたはソースカタログも更新する場合を除きます。

テストを実行

CIが使用するのと同じローカル検証レイヤーを実行します：

npm run check

これにより、ルールの再生成、エビデンスフィクスチャの実行、JavaScript構文のチェック、JSONデータファイルの解析、生成されたファイルの同期確認、プライバシー/セーフティガードレールの実行が行われます。

便利な個別チェック：

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

手動ブラウザチェック

パッケージ化されていない拡張機能を読み込んだ後、このフォルダから簡単なローカルサーバーを起動します：

python -m http.server 8080

次に開きます：

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

GetBlocked! を有効にすると、トラッキングパラメータがページURLから削除され、ポップアップにページレベルのトラッカーアクティビティが表示されます。前後を確認するには、ブラウザのネットワークパネルを拡張機能を無効にした状態と有効にした状態で比較してください。

コントリビューター向けリンク

• 貢献ガイド
• トラッカーの追加
• 壊れたサイト
• 開発ガイド
• 初めてのIssueに最適
• ラベルガイド
• ローンチコピー
• セキュリティポリシー

ライセンス

MITライセンス。 LICENSEを参照。