SEO Monthly Report

月度汇总报告模块

核心功能

月底汇总所有子模块数据，生成一份 React 交互看板。这不是简单的数据堆砌——而是帮你快速看清"这个月发生了什么、接下来该做什么"。

数据输入

在生成月度报告前，先按顺序调用其他三个子模块获取当月数据：

1. keyword-ranking → 当月关键词排名历史、报警事件、新发现关键词
2. content-performance → 内容表现汇总、衰退清单、新内容追踪、更新提醒
3. competitor-content → 竞品新内容清单、排名变化、上升文章分析、内容缺口

React 看板结构

生成一个完整的 .jsx 文件，包含以下 Tab 页：

Tab 1：总览仪表板（Overview）

核心 KPI 卡片（月环比）：

每个 KPI 卡片用颜色指示变化方向：绿色上升、红色下降、灰色持平。

排名分布饼图：

• #1-3 位关键词数量
• #4-10 位
• #11-20 位
• #20+ 位

与上月对比。

本月报警事件时间线： 按日期排列的报警事件（排名大幅下滑、竞品超越等），可点击查看详情。

Tab 2：关键词详情（Keywords）

排名变化表格（可排序、可筛选）：

支持：

• 按类别（A/B/C/D）筛选
• 按变化幅度排序（看最大涨跌）
• 按搜索引擎（Google/Bing）切换
• 搜索关键词

关键词趋势折线图： 选择任意关键词，显示过去 4 周的排名趋势折线。品牌和竞品在同一图上对比。

新发现的关键词机会： 本月通过 SEMrush 和 Search Console 发现的新关键词，标注搜索量和当前排名。

Tab 3：内容表现（Content）

内容表现热力图： X 轴为时间（周），Y 轴为文章，颜色深浅表示点击量变化——一眼看出哪些文章在涨、哪些在跌。

衰退内容清单： 标记为衰退的文章列表，包含：

• 文章标题和 URL
• 下降幅度
• 可能原因
• 建议动作
• 最后更新日期

新文章观察追踪： 本月新发布文章的表现进展，是否达到预期。

更新提醒队列： 需要更新的文章清单，按紧急程度排序。

Tab 4：竞品动态（Competitors）

竞品新内容时间线： 按日期展示竞品本月发布的所有内容，按板块（Blog/Docs/Updates 等）用标签颜色区分。

竞品排名变化 Top 10： 排名上升最多的竞品文章，附深度分析摘要。点击可展开完整分析。

关键词争夺地图： 可视化展示品牌和竞品之间的关键词争夺关系：

• 我们独占的关键词（绿色）
• 竞品独占的关键词（红色）
• 双方都有排名的争夺词（黄色，标注各自排名）

竞品估算流量趋势： 过去 3 个月的竞品流量变化趋势图。

Tab 5：行动建议（Action Plan）

这是报告最核心的 Tab——不是数据，是接下来该做什么。

自动生成的行动建议清单：

每条建议包含：

• 优先级：🔴 高 / 🟡 中 / 🟢 低
• 建议内容：具体要做什么
• 原因：为什么要做这个
• 预期影响：做了之后预计能改善什么
• 关联数据：支持这条建议的数据来源

建议生成规则：

联动提示：

当行动建议涉及到其他 skill 时，明确标注：

🔗 建议 #3 可联动执行：
   → 调用 aeo-content-strategy：挖掘 "enterprise AI agent" 相关的 Reddit 讨论和长尾问题
   → 调用 seo-aeo-diagnostics：对 /blog/ai-agent-guide 页面做技术诊断

技术实现注意事项

React 看板技术栈

- React（函数组件 + Hooks）
- Tailwind CSS（核心样式类）
- Recharts（折线图、饼图、柱状图）
- 数据直接内嵌在组件中（因为是静态报告，不需要 API 调用）
- Tab 切换用 useState 控制
- 表格支持排序和筛选

数据组织

将所有子模块收集的数据整合为一个 reportData 对象，结构如下：

const reportData = {
  meta: {
    brand: "品牌域名",
    competitors: ["竞品1", "竞品2"],
    period: "2026-02",
    generatedAt: "2026-02-28"
  },
  overview: {
    kpis: { clicks, impressions, ctr, avgRank, top10Keywords, estimatedTraffic },
    kpisPrevMonth: { ... },  // 上月数据用于环比
    alerts: [{ date, type, message, severity }]
  },
  keywords: {
    tracked: [{ keyword, category, googleRank, bingRank, change, competitor1Rank, competitor2Rank, weeklyHistory }],
    newOpportunities: [{ keyword, volume, currentRank, source }]
  },
  content: {
    articles: [{ url, title, clicks, impressions, avgRank, trend, lastUpdated }],
    decaying: [{ url, title, declinePercent, reason, suggestedAction }],
    newArticles: [{ url, title, publishDate, currentRank, status }],
    updateQueue: [{ url, title, reason, urgency }]
  },
  competitors: {
    newContent: [{ competitor, url, title, date, type, targetKeywords }],
    risingArticles: [{ url, title, keywordChange, analysis }],
    keywordBattle: { brandOnly, competitorOnly, contested },
    trafficTrend: [{ month, brandTraffic, competitor1Traffic, competitor2Traffic }]
  },
  actionPlan: [{ priority, action, reason, expectedImpact, linkedSkill }]
};

配色方案

品牌色：蓝色系（#3B82F6）
竞品色：红色系（#EF4444）和橙色系（#F59E0B）
上升/正面：绿色（#10B981）
下降/负面：红色（#EF4444）
中性：灰色（#6B7280）
背景：深色（#111827）或浅色（#F9FAFB）——根据用户偏好

交付方式

1. 生成 .jsx 文件到 /mnt/user-data/outputs/
2. 文件命名：seo-monthly-report-YYYY-MM.jsx
3. 同时输出对话内摘要——给不想看看板的场景提供快速总结