# UsherStats documentation

> Human-only web analytics, crawler and AI-bot insight, and bot protection. No cookies. Every page below is also served as Markdown at the URL shown.

## Start

- [UsherStats documentation](https://docs.usherstats.com/index.md): How to install UsherStats, read its dashboards, and use its API, MCP server, bot protection and proxy mode.
- [Getting started](https://docs.usherstats.com/getting-started.md): From a new account to your first counted pageview in about five minutes.
- [Installing](https://docs.usherstats.com/installing.md): Install UsherStats with the snippet, a first-party path on your own domain, the Worker SDK, or proxy mode.

## Understand

- [Concepts](https://docs.usherstats.com/concepts.md): What UsherStats counts as a pageview, a session, a bot, internal traffic and an AI referral, and how long data is kept.
- [Dashboards explained](https://docs.usherstats.com/dashboards.md): What each UsherStats dashboard view shows, People, Crawlers, Internal, Behaviour, Search and Bot protection.
- [Goals and A/B tests](https://docs.usherstats.com/goals-and-experiments.md): Count signups, downloads and clicks as goals, and run A/B tests on people only, without cookies.

## Features

- [Bot protection](https://docs.usherstats.com/bot-protection.md): UsherStats can decide, for every request to your site, whether to serve it, ask the visitor to prove they are a person, or refuse it. It runs inside your o
- [Proxy mode](https://docs.usherstats.com/proxy-mode.md): Proxy mode puts UsherStats in front of your site without any code: you point a hostname at us, and every request to it gets analytics and bot protection an
- [Search Console and Bing setup](https://docs.usherstats.com/search-console-and-bing.md): Connect Google Search Console and Bing Webmaster Tools to UsherStats with your own access, two ways for Google.

## API & agents

- [API and tokens](https://docs.usherstats.com/api-and-tokens.md): The UsherStats REST API, API tokens and their scopes, errors, and where the full reference lives.
- [Accounts and sign-in](https://docs.usherstats.com/api/auth.md): People sign in with an email and password; the API answers with a session cookie, us_session (HttpOnly, Secure, SameSite=Lax, 30 days, extended while in us
- [API tokens](https://docs.usherstats.com/api/tokens.md): An API token lets a program -- a script, a CI job, an AI agent -- use the API as a person with the same scopes could, including making and revoking other t
- [Sites, hostnames and keys](https://docs.usherstats.com/api/sites.md): A site is what UsherStats measures: a name, a time zone, the hostnames it is served on, and its keys.
- [Workspace and members](https://docs.usherstats.com/api/members.md): A workspace holds sites and the people who work on them. Each person has a role, and the role decides their scopes:
- [Agents and MCP](https://docs.usherstats.com/agents-and-mcp.md): Give an AI agent access to UsherStats through the API, the OpenAPI description, the MCP server and these docs as Markdown.
- [Analytics](https://docs.usherstats.com/api/analytics.md): Every figure in the dashboard comes from one query catalogue, and the API exposes it as it is: you name a metric set , a dimension and a few numbers, and U
- [Bot protection settings](https://docs.usherstats.com/api/bot.md): A site's bot protection is a mode, what to do with declared bots no rule names, and a list of rules; how the gate uses them is in Bot protection . Reading 
- [Export](https://docs.usherstats.com/api/export.md): Everything UsherStats keeps for a site, on every plan; what each part holds is in Exporting your data . An export needs the export:read scope.
- [Goals, experiments and behaviour](https://docs.usherstats.com/api/goals.md): Goals and A/B tests are part of a site's settings; their results come from the same data as the dashboard's Behaviour view. How to send events and mark exp
- [Search connections](https://docs.usherstats.com/api/search.md): Google Search Console and Bing Webmaster Tools, connected with access you give and can take back; the setup on Google's and Bing's side is in Search Consol

## Data & account

- [Exporting your data](https://docs.usherstats.com/data-export.md): Export everything UsherStats holds for your sites, raw records and daily totals, from the dashboard or the API.
- [Privacy and compliance](https://docs.usherstats.com/privacy-and-compliance.md): What UsherStats records about your visitors and what it does not, cookies, Global Privacy Control, GDPR roles, and what to tell your readers.
- [Billing and plans](https://docs.usherstats.com/billing-and-plans.md): UsherStats plans, what counts towards them, overage, and how billing works.
- [Troubleshooting](https://docs.usherstats.com/troubleshooting.md): Fixes for missing pageviews, missing crawler data, real people being challenged, and empty Search data.

## More

- [UsherStats for AI agents (MCP)](https://docs.usherstats.com/agents/mcp.md): UsherStats is a remote Model Context Protocol server. Point any MCP client -- Claude Code, Claude Desktop, Cursor, or your own agent -- at
- [Plans and billing](https://docs.usherstats.com/billing.md): Every plan has every feature: analytics, crawler and AI-bot analytics, journeys, A/B tests, bot protection, Search Console, the API and MCP. Plans differ o

All pages in one file: https://docs.usherstats.com/llms-full.txt