# 快速开始

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

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

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

```bash
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. 安装代码

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

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

## 3. 查看报表

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

## 4. 用 API 读取

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

```bash
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 接入](/docs/mcp)。