用途:通过 GA4 Data API 拉取 Google Analytics 4 数据,转化为按优先级排序的可执行建议。脚本为 TypeScript,用 Bun 或 npx tsx 运行。
主要能力:daily-report.ts 生成 SEO 每日报告(默认模板含自然搜索 KPI 28 天对比、异常检测、趋势、落地页、搜索引擎、国家、设备与自动建议);ga-client.ts 执行任意指标×维度查询;analyze.ts 提供 seo、overview、sources、content、devices 等预置分析。
使用方式:设置环境变量 GOOGLE_ANALYTICS_PROPERTY_ID(数字属性 ID,非 G- 开头)与 GOOGLE_APPLICATION_CREDENTIALS(服务账号 JSON 路径),在 scripts 目录执行 bun install,然后运行如 bun run daily-report.ts --property 123456789。无 Bun 时改用 npx tsx 并手动导出环境变量。可用 cron 或 Claude Code /schedule 每日自动运行。
适用场景:网站表现回顾、自然搜索与落地页分析、流量来源、跳出率高的页面诊断、时段对比、移动端与桌面端转化差异。
限制:使用批量报告 API,不支持实时/流式分析;只读,不能修改 GA 配置、受众或事件;仅返回聚合数据,无 PII;GA4 不含关键词、展示、CTR、平均排名数据,需配合 Google Search Console。凭据仅从环境变量读取,服务账号应仅授予 Viewer 角色,密钥不得提交到版本库。