mcpField
A
ads-audit

ads-audit

github.com/hainrixz营销与增长10264 次安装3 天前更新
代码仓库

关于 ads-audit

ads-audit 是面向广告主和营销人员的多平台广告账户审计技能。它并行检查 Google、Meta 和 TikTok 数据，评分并生成分级行动计划与快速改进项。

主要功能

  1. 01收集导出文件、截图或 API 数据
  2. 02委派 Google、Meta、TikTok 专项审计
  3. 03验证并汇总平台评分
  4. 04生成审计报告与优先级行动计划
  5. 05筛选高影响快速改进项

适用场景

  1. 01比较多个广告平台的账户健康状况
  2. 02定位追踪、预算或广告结构问题
  3. 03安排紧急修复和后续优化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hainrixz/claude-ads --skill ads-audit

安装后在 Claude Code 中输入/ads-audit确认已加载。

详细介绍

全平台广告审核

流程

  1. 收集账户数据：请求导出文件、屏幕截图或 API 访问权限
  2. 验证：确认至少有一个平台的数据可用，然后再继续
  3. 识别业务类型：分析每个广告编排器提供的账户信号
  4. 识别活跃平台：确定正在使用哪些平台
  5. 委派给子 Agent（3 个并行的深度专项 Agent，每个平台各一个）：
    • audit-google：转化跟踪、浪费的支出、结构、关键字、广告、设置、PMax、AI Max、Demand Gen、CTV、YouTube 视频广告系列（G01-G74、G-PM*、G-AI*、G-DG*、G-CTV*）
    • audit-meta：Pixel/CAPI 状态、创意疲劳、结构、受众、Andromeda、Advantage+（M01-M40、M-AN*、M-AT*、M-CR*、M-ST*、M-IA*、M-TH*）— 已接入 MCP
    • audit-tiktok：Pixel + Events API + ttclid、创意多样性、Smart+、GMV Max、Symphony、学习阶段（T01-T25、T-SR*）
  6. 验证：在汇总之前，确认每个子 Agent 都返回了包含必需字段的有效评分
  7. 评分：计算各平台及汇总的广告健康评分（0-100）
  8. 报告：生成按优先级排序的行动计划，并列出快速见效项

数据收集

询问用户有哪些可用数据。接受以下任意组合：

  • Meta Ads：Capa 1（claude.ai Facebook MCP，免费）、Capa 2（scripts/api/meta_fetch.py → meta-data.json）、Capa 3（Ads Manager 导出文件 + Events Manager 屏幕截图 + EMQ）
  • Google Ads：Capa 1（cohnen/mcp-google-ads，免费）、Capa 2（scripts/api/google_fetch.py → google-data.json）、Capa 3（账户导出文件 + Change History + Search Terms Report）
  • TikTok Ads：Capa 1（AdsMCP/tiktok-ads-mcp，免费）、Capa 2（scripts/api/tiktok_fetch.py → tiktok-data.json）、Capa 3（Ads Manager 导出文件 + Pixel/Events API 状态）

如果没有可用的导出文件，请根据屏幕截图或手动输入的数据进行审核。

评分

阅读 ads/references/scoring-system.md 了解完整算法。

各平台权重
平台类别权重
Google转化 25%、浪费 20%、结构 15%、关键字 15%、广告 15%、设置 10%
MetaPixel/CAPI 30%、创意 30%、结构 20%、受众 20%
LinkedIn技术 25%、受众 25%、创意 20%、潜在客户开发 15%、预算 15%
TikTok创意 30%、技术 25%、出价 20%、结构 15%、效果 10%
Microsoft技术 25%、联合投放 20%、结构 20%、创意 20%、设置 15%
汇总评分
Aggregate = Sum(Platform_Score x Platform_Budget_Share)
Grade: A (90-100), B (75-89), C (60-74), D (40-59), F (<40)

输出文件

  • ADS-AUDIT-REPORT.md：多平台综合审核结果
  • ADS-ACTION-PLAN.md：按优先级排序的建议（严重 > 高 > 中 > 低）
  • ADS-QUICK-WINS.md：可在 15 分钟内修复且影响显著的项目

报告结构

执行摘要
  • 汇总广告健康评分（0-100）及等级
  • 各平台评分
  • 检测到的业务类型
  • 已识别的活跃平台
  • 所有平台中最重要的 5 个问题
  • 所有平台中最值得优先处理的 5 个快速见效项
各平台章节

每个平台章节包括：

  • 平台健康评分及等级
  • 各类别的明细，以及每项检查的通过/警告/失败状态
  • 平台专属的快速见效项
  • 详细发现及修复步骤
跨平台分析
  • 预算分配评估（实际与建议对比）
  • 跟踪一致性（所有平台是否跟踪相同事件？）
  • 创意一致性（各平台的文案是否保持一致？）
  • 归因重叠（平台是否重复计算转化？）
战略建议
  • 根据业务类型确定平台优先级
  • 预算重新分配建议
  • 扩量机会（适合扩量的平台/广告系列）
  • 停投清单（应立即暂停的广告系列/广告组）

优先级定义

  • 严重：存在收入/数据损失风险（立即修复）
  • 高：显著拖累效果（7 天内修复）
  • 中：优化机会（30 天内修复）
  • 低：最佳实践，影响较小（列入待办）

快速见效项标准

IF severity == "Critical" OR severity == "High"
AND estimated_fix_time < 15 minutes
THEN flag as Quick Win
SORT BY (severity_multiplier x estimated_impact) DESC

评论

支持 Markdown