# clicks.page

> Cookieless, privacy-friendly web analytics for founders and indie hackers, with revenue attribution. Built to be installed and queried by AI agents.

## Setup for agents
- [Agent setup guide](https://clicks.page/setup.md): end-to-end steps an agent can follow to add analytics to a project
- MCP server: https://clicks.page/mcp (Streamable HTTP, header `Authorization: Bearer cpk_…`)
- REST API base: https://clicks.page/api/v1 (same bearer key)

## Tracker
- Script: `<script defer src="https://clicks.page/t.js" data-site="SITE_ID"></script>`
- Custom events: `clicks.track(name, props)` or `data-clicks-event="name"` attributes
- No cookies, no localStorage, honours Global Privacy Control / Do Not Track; bots, headless browsers and datacenter traffic are filtered

## REST API (Bearer cpk_ key)
- GET  /api/v1/sites — list sites
- POST /api/v1/sites {domain} — add a site, returns id + script tag
- GET  /api/v1/sites/{site}/stats?period=30d&source=X — summary, timeseries, top pages/sources
- GET  /api/v1/sites/{site}/breakdown?dimension=source&period=7d — dimension: source, referrer, utm_source, utm_medium, utm_campaign, utm_term, utm_content, country, region, city, device, browser, os, entry, exit, page, event
- GET  /api/v1/sites/{site}/timeseries?period=30d
- GET  /api/v1/sites/{site}/realtime
- GET  /api/v1/sites/{site}/status — installed? last event, monthly usage
- POST /api/v1/sites/{site}/funnel {steps:[{kind:"page",value:"/pricing"},{kind:"event",value:"signup"}], period}
- GET/POST /api/v1/sites/{site}/goals
- POST /api/v1/sites/{site}/revenue {amount (cents), currency, session?, external_id?} — server-side revenue
- GET  /api/v1/sites/{site}/badge — free-forever badge status + embed code; POST …/badge/verify to check the homepage
- periods: realtime, today, yesterday, 24h, 7d, 30d, 90d, month, last_month, 12mo, year, all — or from/to (ISO)