站迹统计 开发者文档
SiteTrace Analytics:免注册的独立网站统计服务。浏览器行为与 HTTP 请求两本账分开统计,区分疑似真人、已验证 AI、自称 AI、其他自动化与未知。数据默认私有。
文档目录
- 快速开始:创建工作区、安装代码、读取第一份报表
- 认证与权限:会话、恢复密钥、API 凭证、OAuth、scope
- 指标与维度:机器可读指标字典的中文说明
- MCP 接入:Remote MCP 工具列表与授权方式
- 访问者分类:五类访问者、AI 客户端注册表与验证方式
- 示例:curl、TypeScript、Python、MCP 客户端
机器可读入口
| 入口 | 地址 | 说明 |
|---|---|---|
| OpenAPI | /openapi.json | 由操作合同生成,与路由同源 |
| MCP | https://openstatx.com/mcp | Streamable HTTP;Bearer API 凭证或 OAuth 授权码 + PKCE |
| llms.txt | /llms.txt | 给 LLM 的导航 |
| ARD | /.well-known/ard.json | Agent Resource Discovery |
| Agent Card | /.well-known/agent-card.json | 能力卡片 |
| 指标字典 | /api/v1/schema/metrics | 公开,无需认证 |
| 能力表 | /api/v1/capabilities/public | implemented / enabled / configured / available |
每个文档页都有 Markdown 版本:在地址后加 .md,例如 /docs/quickstart.md。
数据新鲜度
- 浏览器与 HTTP 采集写入后即可查询(near_real_time,通常 60 秒内)。
- 会话在 30 分钟无活动后结算;未结算的数据标记为 provisional。
- 15 分钟汇总由每 5 分钟一次的定时任务生成;热明细默认保留 7 天,小时汇总 90 天,日汇总 365 天。
限制
- 本服务不提供 AI 训练次数、AI 回答引用次数或模型收录量;日志无法证明这些事实。
- Site ID 是公开标识,只能写入,不能读取任何数据。
- 本服务不修改你的安全规则、不自动封禁访客。