品牌内容表现追踪模块

核心功能

追踪品牌网站每篇内容的搜索表现和用户行为，识别衰退内容并触发更新提醒。每周运行一次。

数据源与指标

来自 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/、参数特征
- 其他

分类后展示给用户确认。

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）