Add EasyList filter support

privacy-filters/README.md

@@ -1,3 +1,27 @@
+# Privacy filter lists
+
+This directory contains the static filters and userscripts applied before the
+archiver snapshots a page. `bpc-paywall-filter.txt` and `userscript/` come from
+Bypass Paywalls Clean. `lists/` contains bundled ad, annoyance, and cookie
+notice lists for offline/container use:
+
+- `easylist.txt` from `https://easylist.to/easylist/easylist.txt`
+- `ublock-filters.txt` from `https://raw.githubusercontent.com/uBlockOrigin/uAssets/master/filters/filters.txt`
+- `easylist-cookie.txt` from `https://easylist-downloads.adblockplus.org/fanboy-cookiemonster.txt`
+- `ublock-annoyances.txt` from `https://raw.githubusercontent.com/uBlockOrigin/uAssets/master/filters/annoyances.txt`
+- `ublock-cookies.txt` from `https://raw.githubusercontent.com/uBlockOrigin/uAssets/master/filters/annoyances-cookies.txt`
+
+Refresh the bundled lists with:
+
+```sh
+npm run update-filter-lists
+```
+
+The parser supports common ABP/uBO network rules, exceptions, domain/type
+modifiers, cosmetic hiding rules, `:remove()` and `:style(...)` downgrades, and
+AdGuard CSS injection rules. Unsupported procedural filters, HTML filters, and
+scriptlets are skipped.
+
 # Bypass Paywalls Clean filters
 
 Adblocker list which allows you to read articles from (supported) sites that implement a paywall (for a lot of sites you also need to install an userscript).\