ublacklist uBlacklist SERPINFO authoring
A SERPINFO file is a YAML document that tells uBlacklist how to find results on a search engine's pages and where to place block buttons.
Read spec.md for the complete format before writing or reviewing a SERPINFO file.
Workflow
- Inspect the SERP's DOM to find a stable CSS selector for each result's root element, its link, and its title.
- Define a page entry per SERP category (web, images, news, ...) with
matchespatterns for its URLs. - In each result definition, set
root,url, andprops.title; commands beyond bare CSS selectors (upward,attribute,regexSubstitute,or, ...) handle harder layouts. - Set
commonPropswith$siteand$categoryso users can target the engine and category from ruleset expressions. - Add a
buttoncommand if the default block-button placement does not fit the layout.
Validation
The @ublacklist/serpinfo npm package provides the parser and schemas for programmatic validation.