Skip to content

Docs

How to install and read Cookie Free Analytics

Guides for the script, first-party hosting, Watch, the read API, and Google Tag Manager.

Guides

  • What the script sends

    The 1 KB file, the beacon fields, and what never leaves the browser.

  • First-party setup

    Serve the file from your own hostname so list-based blockers miss it. Path rewrite or a CNAME on a subdomain such as c.yourdomain.com.

  • Watch

    HTTP, TLS, and DNS on a hostname you already added. More than a ping. Not a real browser.

  • Read API and MCP

    Dashboard JSON with a bearer token, or OAuth 2.1 at /mcp for Claude, Cursor, and other clients. No visitor hashes.

  • Google Tag Manager

    Consent Initialization default denied, then load /cf.js beside GA4.

Install

There isn’t a separate generic install page yet. After you add a site, the dashboard gives you the snippet to paste in your theme header or any header-scripts plugin.

Platform notes: WordPress, Shopify, and Google Tag Manager. To serve the file from your own hostname, see first-party setup.

Also

How a visitor is counted — the HMAC recipe, including the daily salt we delete.