url-sanitize

Sub-1MB native CLI to remove tracking parameters and unwrap tracking redirects from URLs. Agent-friendly: deterministic, structured (--json), no prompts, pinned multi-source ruleset baked in.

url-sanitize 'https://example.com/?utm_source=x'
# https://example.com/

echo 'https://www.amazon.com/dp/B0/ref=foo' | url-sanitize -
# https://www.amazon.com/dp/B0

url-sanitize --json 'https://www.google.com/url?q=https%3A%2F%2Fexample.org'
# {"kind":"redirected","original":"...","url":"https://example.org/","via":{"source":"clearurls","provider":"google","kind":"unwrap-redirect"}}

url-sanitize --text < notes.md > notes.clean.md   # every URL inside text

See the spec for the full CLI contract, exit codes, and output schema.

Built on url-sanitize-core and the merged ClearURLs, Brave, and Firefox catalog.

License

The CLI code is MIT. The binary embeds rule data under its upstream licenses, ClearURLs (LGPL-3.0-only) and Brave and Firefox (MPL-2.0), so it is distributed as MIT AND LGPL-3.0-only AND MPL-2.0. See LICENSE, NOTICE and LICENSES/ in this crate. The AdGuard source (GPL-3.0) is not embedded.