ad-analytics

name	ad-analytics
description	对广告视频进行多维度分析和评分，提供优化建议
metadata	{"openclaw":{"emoji":"📊","requires":{"bins":["python3","curl"],"env":["ARK_API_KEY"]},"primaryEnv":"ARK_API_KEY"}}

广告素材分析评估 Skill

使用豆包多模态模型对生成的广告视频进行多维度评分和分析，提供优化建议。

使用方法

python3 scripts/analyze_ad.py \
  --video ./ad_video.mp4 \
  --product-info '{"name": "无线耳机", "price": "299元", "features": ["降噪", "长续航"]}' \
  --platform douyin \
  --output ./analysis_report.json

参数说明

参数	类型	必填	说明
--video	string	✅	广告视频路径
--product-info	JSON	✅	商品信息
--platform	string	✅	目标平台：douyin/xiaohongshu/taobao/kuaishou
--output	string		输出报告路径，默认 ./analysis_report.json
--include-suggestions	boolean		是否包含优化建议，默认true
--check-compliance	boolean		是否检查合规性，默认true

输出格式

{
  "taskId": "task_123456",
  "videoPath": "./ad_video.mp4",
  "platform": "douyin",
  "scores": {
    "attraction": 8.5,
    "brandConsistency": 9.0,
    "conversionPrediction": 7.8,
    "compliance": 10.0,
    "overall": 8.6
  },
  "analysis": {
    "strengths": ["视觉冲击力强", "卖点突出", "节奏合适"],
    "weaknesses": ["CTA不够明显", "字幕位置遮挡商品"],
    "suggestions": ["放大CTA按钮", "调整字幕位置", "增加商品特写镜头"],
    "complianceCheck": {
      "passed": true,
      "issues": []
    }
  },
  "analyzedAt": "2026-03-11T12:00:00Z"
}

评分维度说明

维度	说明	权重
吸引力	视频开头3秒的吸引力，是否能抓住用户注意力	30%
品牌一致性	视频风格和商品品牌调性是否一致	20%
转化预测	预测用户看完后的购买意愿	30%
合规性	是否符合平台广告规范，有无违规内容	20%

事件发布

分析完成后会发布 analysis.completed 事件到消息总线。

平台合规规则

会根据不同平台的广告规范进行检查：

• 抖音：禁止夸大宣传、禁止使用绝对化用语、必须清晰标识广告
• 小红书：禁止虚假宣传、必须真实分享、不得过度营销
• 淘宝：禁止虚假承诺、必须如实描述商品、价格标识清晰
• 快手：禁止低俗内容、禁止虚假宣传、保护消费者权益