jrr996shujin-png 品牌内容表现追踪模块
核心功能
追踪品牌网站每篇内容的搜索表现和用户行为，识别衰退内容并触发更新提醒。每周运行一次。
数据源与指标
来自 Google Search Console API
每篇页面的搜索表现：
- 曝光量（Impressions）：搜索结果中被展示了多少次
- 点击量（Clicks）：实际被点击了多少次
- CTR（点击率）：点击 / 曝光
- 平均排名（Average Position）：在搜索结果中的平均位置
- 搜索查询（Queries）：用户搜了什么词看到了这个页面
API 调用：/searchanalytics/query，按页面维度（page）拉取，时间范围为过去 7 天 + 过去 28 天（用于趋势对比）。
来自 Google Analytics API (GA4)
每篇页面的用户行为：
- 用户数（Active Users）
- 会话数（Sessions）
- 平均参与时间（Average Engagement Time）——GA4 中替代了老版的"停留时间"
- 跳出率（Bounce Rate）
- 转化事件（如有配置：注册、下载、购买等）
API 调用：GA4 Data API，按页面路径维度拉取。
来自 SEMrush API
补充数据：
- 该页面排名的关键词数量
- 估算自然流量
- 外链数量（其他网站链接到这个页面的数量）
执行流程
1. 内容清单建立
首次运行时，自动建立品牌网站的内容清单：
- 从 XML Sitemap 获取所有页面 URL
- 或从 Google Search Console API 拉取有曝光的所有页面
- 自动分类：
- Blog 文章：URL 含
/blog/或类似路径 - 产品页：URL 含
/product/、/features/等 - Help Center：URL 含
/help/、/docs/、/support/ - Landing Page：URL 含
/lp/、参数特征 - 其他
- Blog 文章：URL 含
分类后展示给用户确认。
2. 每周数据拉取
每周运行时：
Step 1 — 拉取本周数据
- Google Search Console：过去 7 天各页面的曝光、点击、排名
- Google Analytics：过去 7 天各页面的用户行为数据
- SEMrush：各页面的关键词数量和估算流量
Step 2 — 计算趋势
- 本周 vs 上周的变化率（需要存储历史数据或拉取更长时间范围做对比）
- 过去 28 天的滚动平均趋势
Step 3 — 识别异常
表现上升的内容（好消息）：
- 本周点击量比上周增长 > 20%
- 新进入关键词排名前 10
表现下滑的内容（关注）：
- 本周点击量比上周下降 > 20%
- 排名下滑 > 5 位
3. 内容衰退检测
这是本模块最重要的功能——自动识别需要更新的内容。
衰退判定规则：连续 30 天流量下降 10% 即自动标记。
具体实现：
- 拉取每篇文章过去 30 天的点击量
- 与前一个 30 天对比
- 如果下降 ≥ 10%，标记为 🟡 "衰退预警"
- 如果连续两个月（60 天）下降 ≥ 10%，升级为 🔴 "需要立即更新"
衰退标记后的输出：
🟡 衰退预警：/blog/best-ai-tools-2025
过去 30 天点击：1,240（前 30 天：1,450，下降 14.5%）
排名变化：核心词 "best AI tools" 从 #6 → #9
最后更新：2025-08-15（距今 6 个月）
外链数：23（无明显变化）
可能原因分析：
- 内容时效性下降（标题含 2025，但已进入 2026）
- 竞品可能发布了更新的同类文章
建议动作：
- 更新文章标题和内容为 2026 版本
- 检查竞品同主题最新内容 → 调用 competitor-content 模块
- 补充最新工具和数据
4. 新发布内容追踪
当品牌发布新文章时，进入"新内容观察期"：
| 时间节点 | 检查内容 |
|---|---|
| 第 7 天 | 是否被 Google 收录？初始排名在哪？ |
| 第 14 天 | 排名是否在上升？曝光量趋势 |
| 第 30 天 | 达到稳定排名了吗？点击量是否符合预期 |
| 第 60 天 | 与同类别文章的平均表现对比 |
| 第 90 天 | 长期表现评估，是否进入核心内容行列 |
新文章识别：对比本周和上周的 URL 清单，新增的 URL 自动进入观察期。
5. 更新提醒
除了衰退检测触发的更新提醒，还有时间维度的提醒：
- 文章发布超过 6 个月未更新 → 提醒检查是否需要刷新
- 文章标题或内容中包含年份（如 "2025"）且已跨年 → 🔴 立即提醒
- "Best of" / "Top X" 类榜单文章超过 3 个月未更新 → 提醒更新
输出格式
每周调用时
在对话中返回：
📊 本周内容表现摘要（2026-02-17 ~ 2026-02-23）
🔥 表现上升 Top 3：
1. /blog/ai-agent-guide — 点击 +35%，排名 #4→#2
2. ...
📉 表现下滑 Top 3：
1. /blog/email-automation-tips — 点击 -22%，排名 #8→#14
2. ...
🟡 衰退预警（2 篇）：
- /blog/best-ai-tools-2025 — 连续 30 天下降 14.5%
- /help/getting-started — 连续 30 天下降 11.2%
🆕 新文章观察期：
- /blog/new-feature-launch（第 7 天）— 已收录，初始排名 #23
⏰ 更新提醒：
- /blog/top-10-productivity-apps — 标题含 "2025"，建议更新为 2026 版
被月度报告调用时
输出结构化数据：
- 全部内容的月度表现汇总（按类别）
- 衰退内容完整清单
- 新内容表现追踪结果
- 更新提醒队列
- 月环比核心指标（总点击、总曝光、平均排名、平均 CTR）