站迹统计首页开发者文档OpenAPIllms.txt

MCP 接入

地址：https://openstatx.com/mcp（Streamable HTTP，无会话；每个请求独立创建服务器实例，身份不跨请求共享）。

认证

  1. API 凭证：请求头 Authorization: Bearer stk_...（在后台“工作区 → API 凭证”创建，建议只授予 summary:read 与必要网站）。
  2. OAuth 2.1：通用 MCP 客户端会自动发现 /.well-known/oauth-protected-resource/mcp，走授权码 + PKCE。同意页需要你在本浏览器已打开工作区；你可以勾选权限、限定网站与有效期。

工具列表按凭证权限过滤：只读凭证看不到管理工具；即使手工调用隐藏工具，服务端也会独立校验并拒绝。

工具

工具说明只读
discover_analytics列出本服务的指标字典、维度、报表、功能开关与分类规则版本，以及当前凭证的权限与可见网站数量。是
list_sites列出当前凭证可访问的网站（id、域名、时区、验证与采集状态），可附带今日 PV/UV/HTTP/AI 摘要。是
get_report读取一个网站的标准报表（与网页后台相同口径）。是
query_analytics按白名单指标/维度/筛选执行结构化查询（不接受 SQL）。是
get_realtime最近 30 分钟分钟级 PV 与 HTTP 请求、最近 5 分钟活跃访客（不是精确在线连接数）与最近页面。是
get_sessions读取会话列表、单个会话时间线或访客明细（需 details:read；访客明细仅在 consented 隐私模式下可用）。是
get_event_details读取自定义事件/站内搜索/下载/外链点击（kind=events，汇总级），或最近 HTTP 请求明细（kind=requests，需 details:read）。是
explain_classification返回某个 HTTP 请求被归为 human_likely / ai_verified / ai_claimed / other_automation / unknown 的证据、验证方式、规则版本与信任等级（需 details:read）。是
compare_sites对比多个网站的 PV、各站 UV、会话、AI 引荐、AI 抓取、机器请求、转化与异常。是
create_export为大结果创建 CSV/JSON/NDJSON 导出任务（需 exports:write，且导出字段仍受读取权限限制）。否
get_export查看导出任务状态（pending/processing/completed/failed/revoked）与下载路径；不给 export_id 时列出最近导出。是
get_data_quality接收/拒收/重复、迟到与未来时间、未知率、规则版本与过期、各采集来源覆盖（无分母时覆盖率为 null）。是
get_usage当前工作区的实测用量（事件、查询、导出）与配额。是
traffic_overview兼容别名：等同 get_report(report=overview)。（别名，同 get_report）是
traffic_breakdown兼容别名：按一个维度拆分流量，内部调用 get_report 对应报表。（别名，同 get_report）是
traffic_explain兼容别名：等同 explain_classification。（别名，同 explain_classification）是
add_site在当前工作区添加网站并返回站点 ID 与安装方式（需 sites:write）。否
check_installation返回 JS 安装片段、CNZZ 兼容片段、边缘/服务端接入示例，以及 browser/edge/server/security_logs 各自的采集状态与最后数据时间。是
start_site_verification签发网站所有权验证挑战（html_tag / file / dns_txt），返回需要放置的标记或记录。否
check_site_verification按挑战方式检查网站所有权（只抓取该网站自己的 https 地址，带 SSRF 防护；DNS 通过固定解析器）。否
manage_goals管理网站的目标（list 列表 / create 创建 / update 修改 / delete 删除）。否
manage_funnels管理网站的漏斗定义（list 列表 / create 创建 / update 修改 / delete 删除）。否
manage_site_config管理网站设置（settings：get/update，时区、隐私模式、属性白名单、页面分组等；缩短保留期需走 preview_action）、过滤器（filters）、自定义维度白名单（custom_dimensions）与推广成本（campaign_costs）。否
manage_saved_reports保存结构化查询为报表、读取/修改/删除，立即运行（run）并查看运行记录（list_runs）。否
manage_schedules创建/修改/删除日报与周报计划（按站点时区）。否
manage_imports上传旧统计系统导出的 CSV/JSON 汇总（create），预览映射与重叠日期（preview），提交（commit，幂等），查看状态（get）。否
manage_public_shares列出或撤销公开分享（需 shares:write）。否
preview_action预览注册的高风险动作（delete_site_data, delete_site, shorten_retention, enable_public_share, delete_workspace, delete_export），返回影响范围、payload 摘要与执行条件。是

安全