PureStats Agent Documentation

These are public, static documentation responses. They never return account records, analytics, tokens, recovery material or API keys. Reading documentation grants no API access.

Start Here#

• Quickstart: register an identity, prove domain control, create a site and install tracking.
• Authentication: standalone client credentials and existing-account browser consent.
• Machine API contract: use live OpenAPI operation definitions rather than dashboard routes.
• Framework guides: HTML, React, Next.js and Laravel.
• Agent proxy installation: asset caching, optional modules and trusted client IPs.
• Testing: local checks and truthful installation evidence.

Machine-Readable Discovery#

• llms.txt links directly to Markdown, not JavaScript-rendered pages.
• llms-full.txt contains complete live document bodies.
• OpenAPI JSON describes canonical live machine operations and schemas.
• Setup contract includes only authentication, site creation, installation, proxy configuration and test operations.
• Analytics contract provides the analysis workflow without unrelated account settings.
• Documentation manifest lists public Markdown URLs and availability.
• Product documentation source and every current product guide are also available with a .md suffix. YAML frontmatter is removed; code examples and native Markdown content are preserved.

All responses are readable without JavaScript or login. Link headers identify the canonical URL, index and API description. ETag supports conditional GET and HEAD. Shared caches may retain these public documents for five minutes; do not apply that policy to authenticated APIs or OAuth responses.

Integration Boundary#

Only the OpenAPI catalog defines callable machine operations. Do not scrape browser forms, reuse session cookies, infer routes from controller action names or call private administration endpoints. Public tracker configuration and ingestion are not credentials for analytics access.

Future integration requirements are explicitly not a live connector, published plugin or supported public MCP service.

Evidence and Attribution#

PureStats is free with unlimited sites and tracked traffic. Public marketing pages, documentation and articles are server-rendered, and their canonical HTML content remains readable without browser JavaScript. Markdown and API contracts are alternate machine-readable formats, not hidden private data.

The public measurement methodology explains tracker-size evidence, visitor definitions and proxy validation. Fetching a document is not evidence that an agent has installed a working site or that an assistant has cited it. Public ChatGPT and Claude plugins remain unavailable; use the live scoped REST and OAuth contracts.