check-analytics

📊 GA4 审计与网站优化诊断

开发者专用的 GA4 审计工具,系统检测配置漏洞、UA 迁移问题与事件覆盖缺口,输出安全合规的优化建议报告。

收藏
7.9k
安装
2.6k
版本
v0.1.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

check-analytics 是一款专为前端开发者和网站管理员设计的 Google Analytics 审计技能,通过结构化的两步流程帮助用户全面诊断现有分析实现的健康状况。该技能首先扫描代码库中的 gtagdataLayer、GTM 容器 ID 以及 GA4 Measurement ID 等关键标识,识别 Universal Analytics (UA) 等已弃用配置;随后生成包含优先级分级的审计报告,涵盖从硬编码 ID、缺少 Consent Mode 到 SPA 页面浏览追踪缺失等 10 余项常见漏洞。

其核心优势在于纯文档型架构带来的极致安全性与透明度。作为零代码执行的指导型技能,它仅依赖 Claude 的文件搜索与分析能力,不会触发任何网络请求或数据上传,且会自动遮蔽 Measurement ID 后 6 位字符以保护账户隐私。输出的 Markdown 报告采用 🔴🟡🟢 三级优先级体系,清晰标注 Critical 级问题(如 UA 已 sunset)、Warning 级最佳实践违规(如生产环境开启 debug 模式)以及优化建议(如广告拦截器降级方案),并附带事件覆盖度检查表,确保关键转化事件(注册、购买、表单提交)无遗漏。

然而,该技能也存在明显局限性。作为 T3 来源的个人开发者项目,其维护稳定性与长期更新频率存疑;功能上仅限于诊断分析,无法自动修复检测到的代码缺陷,所有优化建议仍需开发者手动实施;此外,其审计范围严格限定于 Google Analytics 生态,对 Mixpanel、Amplitude 等第三方分析工具仅作基础识别,缺乏深度配置检查能力。

该技能最适合以下群体:正在从 UA 迁移至 GA4 的遗留项目维护者、需要确保分析代码符合 GDPR/CCPA 合规要求的隐私官、以及希望标准化团队内 GA 实现方式的前端技术负责人。对于使用 React/Vue/Angular 等现代框架构建的 SPA 应用,该技能能有效检测路由变化时的页面浏览事件缺失问题。

使用风险方面,尽管技能本身安全无害,但用户需注意:审计结果依赖本地代码静态分析,无法检测运行时动态注入的追踪代码;建议的修复方案可能因项目特定架构而需要调整,直接复制模板代码存在潜在兼容性风险;此外,由于不涉及实际执行环境检测,无法验证 GTM 容器是否已正确发布或 GA4 数据流是否接收到了实时命中。建议将生成的报告作为人工代码审查的辅助参考,而非唯一决策依据。

安全解读

核心用法

check-analytics 是一款面向开发者的 Google Analytics 实现审计工具,专注于检测 Web 项目中的追踪代码配置问题。其主要功能包括:

1. 自动扫描识别:搜索项目中各类 Analytics 代码痕迹,涵盖 gtag/dataLayer、GTM 容器、GA4 测量 ID(G-开头)、已废弃的 Universal Analytics(UA-),以及 Mixpanel/Amplitude 等第三方方案。

2. 结构化审计报告:生成包含当前技术栈、检测到的服务商、实现方式(gtag.js/GTM/npm包)等信息的完整报告。

3. 风险分级诊断:按 🔴 关键(Critical)、🟡 警告(Warning)、🟢 建议(Suggestion)三级分类,覆盖 UA 弃用、SPA 页面视图缺失、环境变量硬编码、TypeScript 类型缺失、Consent Mode 未实现、生产环境调试模式等 10 余项检查点。

4. 事件覆盖分析:对照业务场景清单,评估 Page Views、Sign Up、Purchase、Form Submit、Error Tracking 等关键事件是否已部署。

显著优点

  • 精准聚焦 GA 生态:针对 Google Analytics 4 迁移期痛点,特别标注 UA 废弃风险,时效性强
  • 安全优先设计:自动脱敏处理测量 ID(隐藏后6位),避免凭证泄露
  • 框架无关:不绑定特定技术栈,适用于 React/Vue/Angular/Next.js 等主流框架
  • 输出标准化:采用 Markdown 表格和分级 emoji 标识,便于 CI/CD 集成或人工审阅

潜在局限

  • 静态分析为主:无法运行时验证数据是否真实送达 Google Analytics 服务器
  • 无自动修复:仅提供诊断报告,不生成补丁代码
  • 第三方分析支持有限:对 Mixpanel/Amplitude 的检测深度不及 GA 生态
  • 需人工判断优先级:部分建议(如"建议添加 sign_up 事件")需结合业务场景决策

适合人群

  • 负责网站数据埋点的前端工程师
  • 进行 GA4 迁移的数据分析师
  • 需要审计供应商代码质量的技术审计人员
  • 希望建立 Analytics 健康度基线的工程团队

常规风险

  • 误报可能:可能将注释掉的代码或文档示例误判为实际实现
  • 隐私合规盲区:不检测 GDPR/CCPA 法律文本配置,仅检查 Consent Mode 技术实现
  • 版本漂移:Google Analytics 产品迭代快,规则库需持续更新

check-analytics 内容

手动下载zip · 1.6 kB
SKILL.mdtext/markdown
请选择文件