快速开始

1. 创建工作区（无需注册）

在首页输入域名并点击“开始统计”。系统会创建持久匿名工作区、安全会话和第一个网站，并只显示一次恢复密钥。请保存到密码管理器；丢失后无法找回。

程序化创建（适合在受信任环境中由脚本完成）：

curl -sS -X POST https://openstatx.com/api/v1/workspaces \
  -H 'content-type: application/json' \
  -d '{"domain":"example.com","client":"programmatic"}'

返回中的 recovery_key 必须交给人安全保存，不要进入聊天记录；bootstrap_token 是 1 小时有效的受限令牌，只能用于添加网站、获取安装代码和创建只读凭证。

2. 安装代码

<script defer src="https://openstatx.com/tracker.js" data-site="PUBLIC_SITE_ID"></script>

• 默认 basic 隐私模式：不持久化访客标识；UV、回访等需要 consented 模式。
• 单页应用自动跟踪 pushState / replaceState / popstate；hash 路由在网站设置中开启。
• 已使用 CNZZ 的网站可在设置中开启 _czc 兼容层（见 CNZZ 兼容）。

3. 查看报表

后台“网站概况”显示浏览器账本（PV、UV、会话、跳出率）与 HTTP 账本（请求数、AI、自动化）。每页都有“查看接口 / 复制 AI 查询”。

4. 用 API 读取

在“工作区 → API 凭证”创建只读凭证（默认只有 summary:read），然后：

curl -sS https://openstatx.com/api/v1/sites -H "authorization: Bearer $SITETRACE_TOKEN"
curl -sS "https://openstatx.com/api/v1/sites/$SITE_ID/overview?preset=last_7_days" -H "authorization: Bearer $SITETRACE_TOKEN"

示例中的凭证都从环境变量读取（SITETRACE_TOKEN）；不要把工作区恢复密钥交给 AI 或写进脚本。

5. 接入 AI（MCP）

把 https://openstatx.com/mcp 添加为 Remote MCP 服务器。支持自定义请求头的客户端直接使用 Authorization: Bearer stk_...；通用客户端使用 OAuth 授权码 + PKCE，在同意页勾选权限与网站。详见 MCP 接入。