claude-ads 是什么?

Claude Ads 是一个面向付费广告(PPC)审计与优化的 Claude Code 技能:用 /ads 系列命令对 Google、Meta、YouTube、LinkedIn、TikTok、Microsoft、Apple、Amazon 等平台的广告账户跑 250+ 项检查,给出 0-100 的加权 Ads Health Score 和优先级行动计划,还能并行多个 subagent、按行业模板做分析、并用 AI 生成创意。它强调全程在你本机经 Claude Code 运行、广告数据不上外部服务器(用 MCP 接 API 时数据在你机器与平台 API 间直连)。Python(技能 + agent),MIT。面向 PPC 代理、品牌内部营销与自由顾问。

⭐ 4,681 Stars 🍴 742 Forks Python MIT 作者: AgriciDaniel
来源:README 顶部/Who this is for/Features;GitHub desc,license MIT 查看 GitHub 仓库 →

为什么值得关注

约 5.1k 星,热度来自把『广告账户审计』这件费时费专业的活做成 Claude Code 一键技能:代理本来一季度才审一次的账户,现在能每周审、且跨 8 个平台、出可交付报告。它不是空泛提示词,而是 250+ 项可核验检查 + 加权评分 + 质量门(kill rule、预算充足度、学习期保护、合规)+ 41 个 pytest 评测,专业度高,对 PPC 从业者吸引力强。

来源:GitHub 5,137 stars / 782 forks,created 2026-02-11;README Who this is for/Coverage

核心功能

8 平台 250+ 项审计

按平台覆盖 Google(80)、Meta(50)、LinkedIn(27)、TikTok(28)、Microsoft(24) 等可核验检查,外加 Apple/Amazon/Attribution+服务端等;Google/Meta/LinkedIn/TikTok/Microsoft 的 209 项与 check-catalog.yaml 双向校验、不通过 CI 就不能漂移。

来源:README Features(Coverage by platform)
Ads Health Score(0-100)+ 质量门

带严重度乘子的加权评分给 A-F 等级与行动优先级;强制质量门如『不带智能出价不推广泛匹配』『CPA >3x 目标立即暂停』『预算充足度(Meta≥5x、TikTok≥50x CPA)』『学习期不改』『特殊广告类目合规』『隐私基础设施门(Consent Mode V2/CAPI/AdAttributionKit)』等。

来源:README Features(Ads Health Score/Quality gates)
并行 subagent + 行业检测

/ads audit 派发多个并行 subagent 做多平台审计;自动从账户信号(产品 feed、转化事件、平台组合、定向)检测业务类型并加载行业基准与模板;含 26 个 2026 当下基准的参考文件。

来源:README Quick Start/Features(Industry detection/Reference data)
AI 创意生成管线

4 个专门 agent 的创意流水线(/ads dna → /ads create → /ads generate → /ads photoshoot),从品牌 DNA 到创意生成到出图。

来源:README Features(Creative pipeline)
跨运行时 + 评测 + 本地隐私

可装进 Claude Code(插件,推荐)、Codex CLI、Cursor、Windsurf、Gemini CLI、Goose(install.sh/.ps1 --target,含白名单校验);41 个 pytest 评测在 CI 跑(路由快照、检查目录覆盖、评分确定性、SSRF 回归);数据全程本地、不上外部服务器。

来源:README Installation/Eval harness/Data handling & privacy

技术架构

一套 Claude Code 技能 + 多 agent + 参考数据的工程(Python)。skills/ 定义 /ads 各命令(audit/plan/google/meta/amazon/attribution/tracking/dna/create 等)的技能逻辑,agents/ 是并行做各平台审计与创意生成的 subagent,ads/references/ 是知识库(26 个含 2026 基准、出价决策树、平台规格、合规、转化跟踪、MCP 集成、以及 10 原则思考框架),ads/ 与 research/ 放审计逻辑与研究,.claude-plugin 支持插件市场安装。质量上 tests/ 有 41 个 pytest(检查目录与 SKILL.md 双向校验、评分数学确定性、路由快照、SSRF 回归)在 CI 跑,确保检查项不静默漂移、评分可复现。运行机制:在 Claude Code 发 /ads 命令 → 技能(必要时经 MCP 连平台 API 取实时数据)跑 250+ 检查 → 加权评分 + 质量门 → 多 agent 汇成报告与行动计划,全程本机。整体是『技能/agent + 可核验检查目录 + 加权评分 + 行业基准 + 创意管线 + 跨运行时安装』的广告审计工具。

来源:README Architecture/Features/Eval harness;tree(skills/、agents/、ads/、research/、evals/)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code / Codex / Cursor / Windsurf / Gemini / Goose(运行环境)Claude Code /… MCP(连各广告平台 API 取实时数据)MCP(连各广告平… pytest(41 测试评测)pytest(41 测试… check-catalog.yaml(检查目录双向校验)check-catalog.… AI 创意生成(出图)AI 创意生成(出… 8 平台 250+ 项审计 Ads Health Score(0-100)+ 质量门Ads Health Score(0… 并行 subagent + 行业检测并行 subagent + 行业… AI 创意生成管线 跨运行时 + 评测 + 本地隐私跨运行时 + 评测 + 本… claude-ads 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python框架Claude Code 技能 + subagent
Claude Code / Codex / Cursor / Winds…MCP(连各广告平台 API 取实时数据)pytest(41 测试评测)check-catalog.yaml(检查目录双向校验)AI 创意生成(出图)
本地运行的 agent 技能;数据本机、不上外部服务器;MCP 时与平台 API 直连;多运行时安装
来源:README Installation/Data handling;requirements.txt

快速上手

三种装法:①Claude Code 插件(推荐,/plugin 安装);②一键脚本(Unix/macOS 跑 install.sh、Windows 跑 install.ps1);③跨运行时(install.sh/.ps1 --target=codex|cursor|windsurf|gemini|goose,带白名单校验)。装好后在 Claude Code 里:`/ads audit` 跑多平台审计、`/ads google|meta|amazon ...` 单平台深挖、`/ads plan ` 按业务类型做规划、`/ads report` 出报告、`/ads math`/`/ads test` 校验。要拿实时账户数据需经 MCP 连对应平台 API(数据在本机与 API 间直连)。
来源:README Installation/Quick Start/Commands

使用场景

适合:①管 5+ 账户的 PPC 代理,想每周而非每季审计每个账户;②跨 4+ 平台的品牌内部营销,要 exec 评审前的『第二双眼睛』;③自由 PPC 顾问,用 10 分钟审计锚定 day-1 客户范围;④想用一致的检查标准 + 评分 + 行动计划跨平台诊断广告的人。不适合:不投放付费广告的人;不使用 Claude Code/Codex/Cursor 等的人;以及把审计建议当确定保证的人——基准与平台规则常变、建议是诊断性的,最终投放决策与预算风险仍在自己。

来源:README Who this is for/Use cases,结合广告决策风险推断

优势与局限

优势

  • 专业且成体系:250+ 项检查 + 加权 Ads Health Score + 质量门,远超泛泛『帮我看看广告』
  • 可核验:209 项检查与目录双向校验、41 个 pytest 在 CI 跑,评分确定、不静默漂移
  • 覆盖广且与时俱进:8 平台 + 归因/服务端跟踪,跟进 Google AI Max、Meta Andromeda 等 2026 新变化
  • 效率高:并行 subagent、行业自动检测 + 模板,把季度级审计压到分钟级、可出客户报告
  • 本地隐私 + 跨运行时:数据不上外部服务器、可装进 Claude Code/Codex/Cursor 等,MIT

局限

  • 广告平台规则与基准变化极快,检查项与基准需持续维护,部分平台(Apple/Amazon)检查数仍为估计/在途
  • 审计是诊断性建议,效果与投放决策、预算风险最终在用户,不能当确定保证
  • 要拿实时数据需配 MCP 连各平台 API,权限与配置有门槛;否则只能审你提供的信息
  • AI 创意生成质量受底层模型影响,仍需人工把关合规与品牌
  • 依赖 Claude Code 等 agent 环境,非该生态用户用不了
来源:README Coverage(verified vs estimated)/Quality gates/Data handling;广告领域的固有变动性

最新版本

采用语义化版本,README 标注最新 v1.7.0(Wave 2:新增 /ads amazon、attribution、tracking 子技能,41 测试评测,跨运行时安装矩阵,Google AI Max 与 Meta Andromeda 深度重写,10 原则思考框架);仓库最近 push 2026-05-18(创建于 2026-02-11),更新活跃、有 CHANGELOG 与 Wave 3 规划。

来源:README What's new in v1.7.0;GitHub pushed_at 2026-05-18;CHANGELOG.md

总结评价

Claude Ads 把『广告账户审计』这件又费时又吃专业的活做成了 Claude Code 一键技能,而且做得相当专业:8 平台 250+ 项检查、加权健康分、强制质量门(kill rule/预算/学习期/合规),还有可核验的检查目录和 41 个 CI 测试防漂移,并跟进了 Google AI Max、Meta Andromeda 这些 2026 新变化。对管多账户的 PPC 代理或跨平台投放的营销人,它能把季度级审计压到分钟级、出客户报告,5.1k 星合理。要清醒的是:广告规则基准变化极快需持续维护、部分平台检查数仍是估计、审计是诊断建议而非保证、要实时数据还得配 MCP。对在用 Claude Code 做付费广告的人,这是当前最成体系的审计技能之一。

来源:综合 README 定位/检查体系/评测、tree 工程结构、广告领域变动性的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 00:35. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件