广告数据分析

v1.0.2

广告投放数据分析。当用户上传 Excel/CSV 广告报表,或说"帮我分析投放数据/看看这个报表/哪个计划效果差/数据有没有问题"时触发。自动识别所有表头列,无需预设字段名,汇总全部指标,检测异常,生成可视化图表,输出分析报告和优化建议。支持巨量引擎、腾讯广告、Meta Ads、Google Ads、快手等平台导...

2· 136· 3 versions· 1 current· 1 all-time· Updated 23h ago· MIT-0
byMing@ming0429

Install

openclaw skills install ad-analyzer-yima

广告数据分析 Skill

分析用户上传的广告报表,自动识别所有列,汇总指标,检测异常,生成图表,输出优化建议。

Setup

无需任何配置,开箱即用。支持 .xlsx / .xls / .csv,兼容 UTF-8 / GBK 编码。

Usage

用户上传文件后,将完整分析脚本保存为文件再执行。不要用 -c 内联方式运行,内联模式不支持多行缩进代码。

正确执行方式:

# 第一步:把 scripts/analyze.py 脚本保存到本地
# 第二步:执行
python3 analyze.py --file /path/to/report.xlsx --out ./charts

分析脚本说明

脚本位于 scripts/analyze.py,执行后自动完成以下步骤:

  1. 读取文件 — 自动识别 xlsx/xls/csv,自动尝试 utf-8/gbk 编码
  2. 识别列类型 — 自动区分日期列、维度列(文字)、指标列(数值),不预设列名
  3. 汇总指标 — 所有数值列的合计、均值、最大值、最小值
  4. 分组分析 — 按每个维度列分组汇总,自动排序
  5. 异常检测 — 均值 ±2 倍标准差自动标记异常行
  6. 生成图表 — 输出 5 张 PNG 图表
  7. 输出建议 — 基于数据给出具体优化方向

图表输出

文件名内容
chart_1_totals.png各指标总量柱状图
chart_2_dim_compare.png主维度横向对比图
chart_3_trend.png指标趋势折线图(有日期列时)
chart_4_correlation.png指标相关性热力图(指标≥3时)
chart_5_pie.png主维度占比饼图

Notes

  • 必须保存为 .py 文件执行,不支持 python3 -c 内联模式
  • 完全动态识别列名,表头是什么分析什么,一列不漏
  • 数据不外传,完全本地处理
  • 编码自动识别,兼容国内广告平台导出文件

Examples

分析巨量引擎报表:

python3 analyze.py --file ~/Downloads/report.xlsx --out ~/Desktop/charts

分析腾讯广告 CSV:

python3 analyze.py --file ~/Downloads/tencent.csv --out ~/Desktop/charts

Version tags

data-analyzervk9777sqp2m6dydrbafdjwztwf984zjeglatestvk9777sqp2m6dydrbafdjwztwf984zjeg

Runtime requirements

📊 Clawdis
Binspython3