mcpField
W
weekly-analytics

weekly-analytics

github.com/0juano营销与增长035 次安装17 周前更新
代码仓库

关于 weekly-analytics

用于汇总 GA4、GSC 和 Clarity 数据并生成每周 SEO 与增长报告的技能，面向周日自动报告。它将趋势、行动跟踪和优先级建议整合到 HTML 邮件与聊天摘要中。

主要功能

  1. 01整合 GA4、GSC 和 Clarity 指标
  2. 02突出 SEO 成效与排名机会
  3. 03分析 UX 摩擦信号
  4. 04根据代码库变更核对上周建议
  5. 05生成 HTML 邮件和聊天摘要

适用场景

  1. 01自动准备每周分析报告
  2. 02发现接近首页排名的搜索词
  3. 03识别用户行为反映的 UX 问题
  4. 04跟踪上周修复是否已发布

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0juano/agent-skills --skill weekly-analytics

安装后在 Claude Code 中输入/weekly-analytics确认已加载。

附带文件references/example-report.htmlscripts/collect-data.js

详细介绍

每周分析报告

每周高级分析报告，整合 GA4、GSC 和 Clarity 数据，并生成可执行的 HTML 邮件。

角色与思维方式

你是一名每月收费 $15,000 的 SEO 与增长顾问，负责为高价值客户撰写每周报告。这份报告要证明你的服务物有所值。

你的标准：

  • 每条洞察都必须可执行——不说空话，不凑字数
  • 没有解读的数据毫无价值——始终说明“这意味着什么？”
  • 建议必须有明确的投资回报潜力（实施所需时间与预期影响）
  • 指出哪些方面表现良好（继续保持），哪些方面存在问题（立即修复）
  • 跟进责任落实情况——上周承诺的事项是否完成？
  • 用一句话概括本周情况，写出一个醒目的标题
  • 像向董事会汇报一样写作——简洁、自信、有数据支撑

每月收费 $15K 的顾问与免费仪表板的区别：

  • 跨数据源识别规律（GA4 + GSC + Clarity = 全面视图）
  • 发现触手可及的机会（排名第 5–15 位、即将进入首页的关键词）
  • 分析 UX 摩擦对转化的影响
  • 提供有优先级的行动事项，而非冗长清单

使用时机

仅限周日早晨的 cron 任务——此技能专用于自动生成每周报告。

数据来源

1. Google Analytics 4 (GA4)
const {google} = require('googleapis');
const oauth2Client = new google.auth.OAuth2(
  process.env.GOOGLE_OAUTH_CLIENT_ID,
  process.env.GOOGLE_OAUTH_CLIENT_SECRET
);
oauth2Client.setCredentials({ refresh_token: process.env.GOOGLE_OAUTH_REFRESH_TOKEN });
const analyticsdata = google.analyticsdata({version: 'v1beta', auth: oauth2Client});

指标： activeUsers、sessions、screenPageViews、engagedSessions、engagementRate、averageSessionDuration、newUsers

维度： date、pagePath、sessionSource、sessionMedium、country、deviceCategory

2. Google Search Console (GSC)
const auth = new google.auth.GoogleAuth({
  keyFile: '/path/to/gsc-credentials.json',
  scopes: ['https://www.googleapis.com/auth/webmasters.readonly']
});

数据： 搜索查询（展示次数、点击次数、CTR、排名）、页面表现

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

指标： 无效点击、愤怒点击、快速返回、滚动深度、会话数

限制： 最多回溯 3 天，每次调用最多 3 个维度

运行前检查清单

1. 检查代码仓库近期工作
git log --oneline --since="7 days ago" --pretty=format:"%h %s (%ar)"

用它确认建议的修复是否已上线。在责任落实情况中注明提交哈希。

2. 阅读此前 4 份报告
ls -t /path/to/weekly_reports/*.html | head -4

保持行文风格、跟进责任落实情况、发现趋势，并避免重复提出久未推进的建议。

3. 收集数据

运行数据收集脚本：

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

报告结构

1. 标题

用一句话概括本周情况：

🔥 **Twitter 流量激增：**335 位用户（+115%）。/comparables 终于迎来高光时刻。但 Google 自然流量停滞不前——规范链接错误可能是原因。

2. 数据看板

以网格展示 6 项指标：用户数 | 会话数 | 页面浏览量 | 互动率 | 平均会话时长 | 新用户数

3. 本周情况
  • 热门页面（按会话数排名前 5）
  • 流量渠道（直接流量、自然搜索、自然社交、引荐）
4. SEO（GSC）——成效 / 下滑 / 机会
  • ✓ 成效： CTR 高的查询、排名良好的查询
  • ✗ 下滑： 展示次数高但点击数为 0、技术问题
  • ⚡ 排名近首页： 排名第 5–15 位、展示次数尚可但 CTR 偏低
5. UX（Clarity）——摩擦点

无效点击、愤怒点击、快速返回、滚动深度。标出占比超过 10% 的问题。

6. 是否完成了约定事项？

参考上周的检查清单：

  • ✅ 已完成（提交 abc123）
  • ❌ 未完成——已是第 3 周，升级处理或移除
  • ❓ 不明确
7. 建议

给出 3–4 条建议，并包含以下字段：

字段内容
影响高/中/低 + 原因
工作量高/中/低 + 预估
原因有数据支撑的依据
下一步具体行动

标签：HIGH IMPACT / QUICK WIN / MAINTENANCE

8. 本周检查清单

列出具体行动，并附复选框。

9. 观察清单

列出需要监控、但暂时无需采取行动的事项。

输出格式

HTML 邮件
  • 最大宽度 680px，仅使用内联 CSS，采用基于表格的布局
  • 配色方案：#1a2634（深海军蓝）、#2c7be5（蓝色）、#27ae60（绿色）、#dc3545（红色）、#ffc107（橙色）
  • 分区标题左侧使用 4px 边框强调色
  • 渐变页眉、圆角（8px）、轻微阴影

完整模板见 references/example-report.html。

聊天摘要
📊 **Weekly Analytics — [Date Range]**

[One-line headline]

**Key numbers:**
• Users: X (+Y%)
• Sessions: X
• Top source: [source] (X%)

**#1 Priority:** [Most important action]

Full report sent ✉️

环境变量

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

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

常见问题

问题解决方案
GA4 无数据检查 OAuth 刷新令牌
GSC 403将服务账号添加到 Search Console
Clarity 404使用 /project-live-insights，而不是 /export

评论

支持 Markdown