seo-ai-social-report

统一的 SEO + AI + 社交报告

大多数报告都要求客户分别查看三个工具。本报告将这些内容汇总为一个视图：来自 SE Ranking 的搜索排名和 AI 搜索可见度、来自 Planable 的社交互动数据，以及适合快速浏览的文字结论和用于查看详情的交互式 HTML 报告。

前提条件

• 已连接 SE Ranking MCP（使用项目可以获得最清晰的排名趋势；不使用项目时，Data API 历史数据也可用）。
• 已连接 Planable MCP，并配置好工作区和已连接的页面。
• 用户提供：域名和品牌、市场/国家/地区（默认 us）、Planable 工作区、报告周期（默认：上一个自然月），以及可选的竞争对手（用于计算声量份额）。

连接器健康检查

在执行其他操作之前，先确认两个 MCP 均可访问：

• **SE Ranking：**调用 DATA_getSubscription。如果调用失败或返回认证错误，立即停止并告知用户：

  “SE Ranking 连接器未响应，请先重新连接，然后再继续。设置指南：https://seranking.com/api/integrations/mcp/”

• **Planable：**调用 list_workspaces。如果调用失败或返回认证错误，立即停止并告知用户：

  “Planable 连接器未响应，请先重新连接，然后再继续。设置指南：https://help.planable.io/hc/en-us/articles/27538577098780-How-to-connect-Planable-MCP-to-your-AI-tools”

只有在两个调用均成功返回后，才能继续执行以下流程步骤。

流程

1. 确定范围

确认域名、Planable 工作区、报告周期和竞争对手。将报告周期转换为明确的开始和结束日期。

2. 获取 SEO 数据（SE Ranking）

• **使用项目时：**调用 PROJECT_getSummary 和 PROJECT_getPositionHistory(site_id, type: avg_pos | visibility, date_from, date_to) 获取排名趋势；也可以复用已完成的审计（PROJECT_listAudits → getAuditReport）获取网站健康度数据。
• **不使用项目时：**调用 DATA_getDomainOverviewWorldwide 获取概览快照。
• **快捷方式：**第 3 步中的 AI 概览调用（时间序列视图）已返回所选国家/地区的月度 organic_traffic / overall_traffic 数据流。可以直接复用这些数据绘制自然流量趋势图，无需单独调用历史数据接口。

3. 获取 AI 搜索数据（SE Ranking）

• 调用 DATA_getAiSearchOverview(target, source, brand?)，使用默认的时间序列视图，获取品牌曝光、链接曝光、AI 机会流量、平均排名和月度趋势数据流（包括自然流量/整体流量）。如果 previous 为 null，则将其视为基准值，不要把 change_percent 的 100% 显示为增长。
• 调用 DATA_getAiSearchLeaderboard(primary, competitors[], source, engines[])，获取与竞争对手相比的声量份额（仅在用户提供竞争对手时调用）。查询范围应保持较窄（每次调用选择少量搜索引擎/竞争对手），大规模请求可能超时。

4. 获取社交数据（Planable）

• 调用 list_pages(workspaceId) → 获取页面 ID。
• 调用 get_page_metrics_summary(workspaceId, pageIds, startDate, endDate) — 账号级受众/展示量/互动率。
• 调用 get_post_metrics_summary(workspaceId, pageIds, startDate, endDate) — 时间窗口内的已发布帖子总量。（其统计范围与页面展示量不同，应分开呈现。）
• 调用 get_post_metrics(workspaceId, pageIds, ..., limit: 5) — 获取热门帖子。
• 调用 list_posts(...) — 获取报告周期内发布的帖子（数量/发布频率）。
• 如需月度社交趋势，按月度时间段分别调用一次 get_page_metrics_summary。

5. 撰写快速结论（聊天）

用约 10–15 行纯文本总结三个方面（SEO、AI 搜索、社交）的主要变化，然后列出 2–3 条具体要点（“有哪些变化”“需要关注什么”）。这是大多数人真正会阅读的部分，因此要简洁有力，以数据为主，不要添加空话。

6. 构建交互式 HTML 报告

以捆绑的模板 assets/report-template.html 为起点——它包含 Planable 配色方案、卡片/分区布局，以及已接入 Chart.js（CDN）的图表，其中包括双轴趋势图。用你获取的真实数据填充模板：

• **KPI 卡片：**自然流量、AI 曝光度 / 声量份额、社交媒体展示次数、互动率、帖子数——有真实的同比或环比变化数据时才填写变化值；否则将变化值留空，绝不要编造。
• 趋势图（交互式）：排名/自然流量趋势、AI 曝光度趋势、社交媒体展示次数与互动率。当两个系列的量级差异很大时（例如，数千的自然流量与数百的 AI 机会流量，或展示次数与互动率），请使用双轴或分开绘制图表——不要把它们压到同一坐标轴上，否则较小的曲线会变成一条平线。
• **声量份额：**绘制品牌与竞争对手的柱状图（没有竞争对手时省略）。
• 热门帖子和动态变化 / 关注事项——与文字摘要中的要点保持一致。

将数据以内联 JavaScript 数组的形式写入文件（不要使用外部数据文件或 localStorage）。将文件保存到 outputs 文件夹，命名为 {client}-{period}-cross-channel-report.html，然后通过 present_files 分享。展示之前验证内联脚本可以解析（快速执行类似 node --check 的检查）。

输出

1. 快速结论——在聊天中简短总结（数据 + 2–3 条要点）。
2. 交互式 HTML 报告——通过 present_files 提供自包含文件，包含 KPI 卡片、可悬停查看的趋势图、声量份额和热门帖子。

提示

• 聊天摘要要简洁；HTML 才是详细报告。不要在聊天中重复完整报告。
• 在报告页脚标注数据来源（搜索/AI 使用 SE Ranking，社交数据使用 Planable），并注明生成日期和准确的日期范围。
• 为便于阅读，可对数字取整（48K、4.2%）；绝不要伪造趋势。如果某个系列只有一个数据点，请展示该点，但不要绘制趋势线。
• 清楚标记不完整的周期（例如，月初至今的数据区间），避免读者将较短的柱子误解为下降。

边界情况和限制

• **不使用 GA4 / Looker Studio。**本报告涵盖两个 MCP 返回的数据——搜索/AI 曝光度和社交互动，而非跨渠道转化归因。请在页脚说明这一点。
• **页面级社交分析有限：**通过连接器通常无法获取 Twitter/X、Pinterest、Threads 和 Google Business Profile 的页面级指标——这些平台会显示在 unsupportedPages 中；合计数据仅基于受支持的渠道，并将其余渠道标注为“数据不可用”。
• **数据稀疏的周期：**如果发布内容很少，或排名几乎没有变化，请如实说明，不要夸大无关紧要的波动。
• **未提供竞争对手：**省略声量份额部分，不要留下空图表。