analytics

Clamp Analytics 是一款轻量级 JavaScript SDK，无需使用 Cookie 或任何个人标识符即可采集产品使用数据。 初始化时只需传入项目 ID，系统便会自动记录页面浏览量和会话信息；同时支持发送自定义事件、识别已登录用户、捕获收入交易以及记录异常错误。 安装非常简便：可通过 npm 添加依赖，或直接粘贴指向 CDN 的单行 script 标签。该脚本会自动读取 data-clamp-project 属性中的项目标识并立即开始采集。 对于 React、Next.js、Vite、Nuxt、SvelteKit、Astro 等前端框架，SDK 提供了专门的集成指南和 React 组件，可直接嵌入根布局中。 API 接口包括 init、track、identify、reset、revenue、getAnonymousId 和 getUserId。track 方法支持以任意名称记录事件，并附带扁平化的键值属性。revenue 是用于订阅和购买事件的类型化辅助方法，会根据计费周期自动计算月度经常性收入（MRR）增量。 在 TypeScript 项目中，可定义类型化的事件映射，为自定义事件提供编译时的自动补全与校验。revenue 事件遵循严格联合类型，强制要求正确的字段组合，适用于订阅、一次性购买及退款等场景。 错误处理可通过启用捕获未处理异常与 Promise 拒绝，将其作为 $error 事件记录，并按指纹分组以便分析。 可选扩展模块支持自动跟踪出站链接、文件下载、404 页面、数据属性驱动的事件、Web Vitals 及区块可见性。各扩展按需加载，确保打包体积最小化。 服务器端采集同样受支持——使用独立构建并配合 API 密钥，可在后端服务、Webhook 或 Server Actions 中发出相同类型的事件，实现统一的事件流。 所有采集数据均存储于 Clamp Analytics 平台，提供免费每月 10 万条事件额度，并内置 Model Context Protocol（MCP）服务器，使事件可被 Claude、Cursor 及 VS Code 插件等 AI 代理直接查询，从而实现自然语言分析能力和自动化洞察。 该 SDK 采用 MIT 许可证发布，代码仓库位于 clamp-sh/analytics。