名称： social-media-analyzer
描述： 社交媒体活动分析与绩效追踪。计算各平台的互动率、投资回报率（ROI）并进行基准对比。适用于分析社交媒体表现、计算互动率、衡量活动投资回报率、对比平台指标或与行业标准进行基准比较。
触发器：
- 分析社交媒体
- 计算互动率
- 社交媒体投资回报率
- 活动表现
- 对比平台
- 基准互动率
- Instagram 分析
- Facebook 指标
- TikTok 表现
- LinkedIn 互动

社交媒体分析器

提供包含互动指标、投资回报率计算和平台基准的活动绩效分析。

目录

• 分析工作流
• 互动指标
• 投资回报率计算
• 平台基准
• 工具
• 示例

分析工作流

社交媒体活动绩效分析流程：

1. 验证输入数据完整性（覆盖人数 > 0，日期有效）
2. 计算每条帖子的互动指标
3. 汇总活动级指标
4. 计算投资回报率（如果提供了广告支出）
5. 与平台基准进行对比
6. 识别表现最佳和最差的帖子
7. 生成优化建议
8. 验证： 互动率 < 100%，投资回报率与支出数据匹配

输入要求

数据验证检查

分析前，请验证：

• [ ] 所有帖子的覆盖人数 > 0（避免除零错误）
• [ ] 互动计数为非负数
• [ ] 日期范围有效（开始日期 < 结束日期）
• [ ] 平台被识别
• [ ] 如果请求计算投资回报率，则支出 > 0

互动指标

互动率计算

互动率 = (点赞数 + 评论数 + 分享数 + 收藏数) / 覆盖人数 × 100

指标定义

表现等级分类

投资回报率计算

计算广告支出回报：

1. 汇总所有帖子的总互动数
2. 计算每次互动成本
3. 计算每次点击成本（如果有点击数据）
4. 使用基准价值估算互动价值
5. 计算投资回报率百分比
6. 验证： 投资回报率 = (价值 - 支出) / 支出 × 100

投资回报率公式

互动价值估算

投资回报率解读

平台基准

各平台互动率基准

各平台点击率基准

各平台每次点击成本基准

完整基准数据请参阅 references/platform-benchmarks.md。

工具

计算指标

python scripts/calculate_metrics.py assets/sample_input.json

计算每条帖子及活动总计的互动率、点击率、覆盖率。

分析表现

python scripts/analyze_performance.py assets/sample_input.json

生成包含投资回报率、基准对比和建议的完整绩效分析报告。

输出内容包括：
- 活动级指标
- 逐条帖子明细
- 基准对比结果
- 表现最佳帖子排名
- 可操作建议

示例

示例输入

参见 assets/sample_input.json：

{
  "platform": "instagram",
  "total_spend": 500,
  "posts": [
    {
      "post_id": "post_001",
      "content_type": "image",
      "likes": 342,
      "comments": 28,
      "shares": 15,
      "saves": 45,
      "reach": 5200,
      "impressions": 8500,
      "clicks": 120
    }
  ]
}

示例输出

参见 assets/expected_output.json：

{
  "campaign_metrics": {
    "total_engagements": 1521,
    "avg_engagement_rate": 8.36,
    "ctr": 1.55
  },
  "roi_metrics": {
    "total_spend": 500.0,
    "cost_per_engagement": 0.33,
    "roi_percentage": 660.5
  },
  "insights": {
    "overall_health": "excellent",
    "benchmark_comparison": {
      "engagement_status": "excellent",
      "engagement_benchmark": "1.22%",
      "engagement_actual": "8.36%"
    }
  }
}

结果解读

该示例活动显示：
- 互动率 8.36% vs 基准 1.22% = 优秀（高于平均水平 6.8 倍）
- 点击率 1.55% vs 基准 0.22% = 优秀（高于平均水平 7 倍）
- 投资回报率 660% = 投资回报非常出色
- 建议： 增加预算，复制成功要素

参考文档

平台基准

references/platform-benchmarks.md 包含：

• 按平台和行业划分的互动率基准
• 有机内容和付费内容的点击率基准
• 成本基准（每次点击成本、每千次展示成本、每次互动成本）
• 各平台内容类型表现
• 最佳发布时间和频率
• 投资回报率计算公式