SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场weekly-analytics

weekly-analytics

营销与增长

查看项目

更新于 10-15 08:48

技能介绍

用途

Weekly Analytics 是一个用于自动生成每周分析报告的技能，将 Google Analytics 4（GA4）、Google Search Console（GSC）和 Microsoft Clarity 三个数据源整合为一封可执行的 HTML 邮件。它的定位是模拟一位月费 15,000 美元的 SEO 与增长顾问，为高价值客户撰写每周报告。该技能明确说明仅用于每周日早上的自动化 cron 任务。

主要能力

报告强调每条洞察必须可执行，数据必须附带解读，建议需具备明确的 ROI 潜力（实施时间与预期影响对比），并追踪上周承诺事项的完成情况。其差异化在于跨数据源的模式识别（GA4 + GSC + Clarity 形成完整视图）、识别“触手可及”的机会（排名 5-15 位、有望进入首页的关键词）、UX 摩擦到转化影响的分析，以及按优先级排列的行动项。

报告结构包括：

  1. 标题：一句话概括本周故事。
  2. 指标看板：6 项指标网格——Users、Sessions、Pageviews、Engagement %、Avg Session、New Users。
  3. 发生了什么：按会话数排列的前 5 页面，以及流量渠道（Direct、Organic Search、Organic Social、Referral）。
  4. SEO（GSC）：胜利（高 CTR 查询、良好排名）、损失（高曝光零点击、技术问题）、触手可及的机会（排名 5-15、曝光尚可、CTR 低）。
  5. UX（Clarity）：摩擦点——无效点击、愤怒点击、快速返回、滚动深度，超过 10% 的问题会被标记。
  6. 我们说到做到了吗：引用上周清单，标注已完成（含 commit 哈希）、未完成（第 3 周则升级或放弃）、不明确。
  7. 建议：3-4 条建议，每条包含 Impact（高/中/低及原因）、Effort（高/中/低及估算）、Why（数据支撑的理由）、Next（具体行动），并打标签 HIGH IMPACT / QUICK WIN / MAINTENANCE。
  8. 本周清单：具体行动的复选框列表。
  9. 观察列表：需监控但暂不行动的事项。

使用方式

运行前需完成检查清单：

  1. 检查仓库近期工作：

git log --oneline --since="7 days ago" --pretty=format:"%h %s (%ar)"

用于确认建议的修复是否已发布，并在问责部分引用 commit 哈希。

  1. 阅读前 4 份报告：

ls -t /path/to/weekly_reports/*.html | head -4

用于匹配语气、追踪问责、发现趋势、避免重复卡住的建议。

  1. 收集数据：

NODE_PATH=/path/to/node_modules node {baseDir}/scripts/collect-data.js --days=7

数据源接入方式：

GA4 使用 googleapis 的 OAuth2 客户端，指标包括 activeUsers、sessions、screenPageViews、engagedSessions、engagementRate、averageSessionDuration、newUsers；维度包括 date、pagePath、sessionSource、sessionMedium、country、deviceCategory。

GSC 使用服务账号 JSON 文件，scope 为 https://www.googleapis.com/auth/webmasters.readonly，数据包括搜索查询（曝光、点击、CTR、排名）和页面表现。

Clarity 通过 curl 调用 API：

curl "https://www.clarity.ms/export-data/api/v1/project-live-insights?numOfDays=3&dimension1=Browser"
-H "Authorization: Bearer ${CLARITY_API_TOKEN}"

指标包括无效点击、愤怒点击、快速返回、滚动深度、会话数。限制：最多回溯 3 天，每次调用最多 3 个维度。

环境变量：

GOOGLE_OAUTH_CLIENT_ID=... GOOGLE_OAUTH_CLIENT_SECRET=... GOOGLE_OAUTH_REFRESH_TOKEN=... GA4_PROPERTY_ID=... CLARITY_API_TOKEN=... CLARITY_PROJECT_ID=...

GSC 使用服务账号 JSON 文件而非 OAuth。

输出格式

HTML 邮件：最大宽度 680px，仅内联 CSS，基于表格布局。配色方案：#1a2634（深海军蓝）、#2c7be5（蓝）、#27ae60（绿）、#dc3545（红）、#ffc107（橙）。区块标题使用 4px 左边框强调，渐变页眉、圆角（8px）、细微阴影。完整模板见 references/example-report.html。

同时提供聊天摘要格式：

📊 Weekly Analytics — [Date Range]

[一句话标题]

关键数字： • Users: X (+Y%) • Sessions: X • Top source: [source] (X%)

#1 优先事项： [最重要的行动]

完整报告已发送 ✉️

适用场景

适用于每周日早上的自动化 cron 任务，为高价值客户生成周度 SEO 与增长分析报告。

限制

Clarity API 最多回溯 3 天，每次调用最多 3 个维度。常见问题：GA4 为空需检查 OAuth refresh token；GSC 403 需将服务账号添加到 Search Console；Clarity 404 需使用 /project-live-insights 而非 /export。