ads

广告：免费优先的付费广告审核与优化

专注分析广告账户，覆盖大多数广告支出所在的 3 个基础平台：Meta、Google、TikTok。由 19 个专业子技能和 7 个 Agent（3 个审核 Agent + 4 个创意 Agent）协同完成。首次使用的用户应输入 /ads start ——这是一个引导式向导，可收集背景信息，逐步指导完成 OAuth 设置，并将所有内容保存到 ~/.claude-ads/profile.json，这样今后的命令就不会再询问。

快速参考

命令	功能
/ads start	首次使用向导——收集背景信息，逐个平台引导配置 OAuth/MCP 并进行实时验证，可选注册 Zernio + Meta Developers。可重新运行 /ads start edit/status/reset。
/ads next	持续优化助手——读取近期审核 JSON + 历史记录，按影响 × 易操作程度对排名前 3 的快速优化项进行排序，并可引导你修复第 1 项。检测与上次审核相比的回退情况。
/ads audit	全平台综合审核，并行委派子 Agent（3 个 Agent：Meta、Google、TikTok）
/ads google	Google Ads 深度分析（搜索、PMax，包括 YouTube 视频广告系列）
/ads meta	Meta Ads 深度分析（FB、IG、Advantage+）——通过 MCP 接入 claude.ai Facebook
/ads tiktok	TikTok Ads 深度分析（Creative、Shop、Smart+、Symphony、GMV Max）
/ads creative	跨平台创意质量审核
/ads landing	评估广告系列的落地页质量
/ads budget	审查预算分配和出价策略
/ads plan <business-type>	使用行业模板制定战略广告计划
/ads competitor	竞争对手广告情报分析
/ads math	PPC 财务计算器（CPA、ROAS、盈亏平衡、预算预测）
/ads test	A/B 测试设计（假设、显著性、时长、样本量）
/ads report	生成 PDF 审核报告，用于交付客户
/ads dna <url>	从网站提取品牌 DNA，输出 brand-profile.json
/ads create	生成广告系列创意概念 + 文案简报，输出 campaign-brief.md
/ads generate	根据简报生成 AI 广告图片，输出到 ad-assets/
/ads photoshoot	以 5 种风格拍摄产品照片（Studio、Floating、Ingredient、In Use、Lifestyle）
/ads update <platform|all>	使用最近 30 天的变更更新各平台参考内容（成本高：每个平台约 50–150k 个 token；需确认后才会执行）
/ads publish	通过 Zernio 将生成的创意发布到 14 个以上的社交网络（前 2 个账户免费；参见 skills/ads-publish/SKILL.md）

首次使用行为

当用户调用除 /ads start、/ads math 或 /ads test 以外的任何 /ads 命令时，首先运行：

python3 scripts/profile.py get

• 退出代码为 2（缺少配置文件）→ 温和地提示一行：

  提示：请先运行 /ads start——今后每条命令可节省约 30 秒。要改为直接在此处继续吗？（Y/N） 如果用户选择 N（继续），则回退到下方的内联上下文收集流程。

• 退出代码为 0（配置文件存在）→ 解析 JSON，并直接使用已保存的 context.industry、context.monthly_spend_usd、context.primary_goal、 context.active_platforms。不要再次询问。只有字段为 null/空值时才重新询问。

上下文收集（备用方案——仅当用户没有个人资料且拒绝了 /ads start 时）

如果没有上下文，基准数据将缺乏针对性，建议也可能不适合用户的情况。

请提前询问以下问题（合并成一条消息）：

1. 行业 / 业务类型：以下哪项最符合您的情况？ 电商 · 本地服务 · 房地产 · 医疗保健 · 金融 · 代理机构 · 其他 （注：由于 B2B 企业、SaaS、移动应用和信息产品模板依赖的 LinkedIn/Apple/YouTube 已不再接受审计，这些模板已在 v2.3.0 中移除；请使用 generic 模板以及下方特定平台的技能。）
2. 每月广告支出：总预算及各平台的预算分配（大致估算即可）
3. 主要目标：销售 / 收入 · 潜在客户 / 产品演示 · 应用安装 · 电话咨询 · 品牌
4. 正在使用的平台：在支持的 3 个平台（Meta、Google、TikTok）中，您在哪些平台投放广告？

如果用户一开始就提供了信息（例如“审核我的 Google Ads，我在电商广告上每月花费 $5k”），请从中提取上下文并继续，无需再次询问。

完成内嵌信息收集后，询问：“要我将这些信息保存到您的个人资料中，以后就不再重复询问吗？（我会根据您的回答快速运行 /ads start。）”

使用提供的上下文来：

• 从 references/benchmarks.md 中选择正确的行业基准
• 提供与预算相符的建议（例如，智能出价要求每月转化次数达到 15 次以上）
• 校准严重程度评分（每月花费 $500 的账户与每月花费 $50k 的账户，优先事项不同）

编排逻辑

用户调用 /ads audit 时，并行委派给子 Agent：

1. 加载上下文——运行 python3 scripts/profile.py get。如果个人资料存在，则使用该资料。如果退出码为 2，则回退到内嵌的上下文收集流程（并在最后提供通过 /ads start 保存信息的选项）。
2. 收集账户数据（导出文件、屏幕截图或粘贴的指标；对于已连接的平台，使用 connections.<p>.tier 中保存的层级）
3. 检测业务类型并识别正在使用的平台（如果可用，则使用 context.active_platforms）
4. 通过 Task 工具并行启动子 Agent，并使用 context: fork——仅针对 context.active_platforms 中的平台（或 connections.<p>.tier != "skipped" 的平台）：audit-google、audit-meta、audit-tiktok
5. 验证：每个子 Agent 都会同时写入 <platform>-audit-results.json 和 <platform>-audit-results.md。解析 JSON，并根据 references/audit-output-schema.json 验证，然后再汇总。如果任一子 Agent 的 JSON 缺失或无效，则显示错误并停止——不得静默汇总不完整的结果。
6. 使用 references/scoring-system.md 中的平台预算占比公式汇总分数，并生成统一的广告健康评分（0-100）
7. 根据每个 JSON 的 quick_wins 和 critical_issues 数组，制定按优先级排序的行动计划
8. 保存到历史记录——对每份新生成的审计 JSON 运行：python3 scripts/profile.py save-audit <platform>-audit-results.json。这将为 /ads next 提供回归检测数据。
9. 建议下一步——引导用户使用 /ads next 查看按优先级排序的快速优化项。

对于单项命令（/ads google、/ads meta 等），直接加载相关子技能。如果尚未提供个人资料或上下文，仍需先加载个人资料 / 收集上下文。

对于 /ads update <platform|all>，转到 skills/ads-update/SKILL.md。更新技能会在获取数据前强制执行成本确认步骤——切勿绕过此步骤。相关原因请参阅 references/update-cost-warning.md。

创意工作流

按顺序执行的流水线（每个步骤都可独立运行）：

1. /ads dna <url> → 在当前目录中生成 brand-profile.json
2. /ads create → 读取个人资料 + 可选的审计结果 → campaign-brief.md
3. /ads generate → 读取简报 + 个人资料 → ad-assets/ 目录
4. /ads photoshoot → 独立运行，或读取个人资料以注入风格

需要 GOOGLE_API_KEY（默认使用 Gemini），或 ADS_IMAGE_PROVIDER + 对应的密钥。 如果缺少 API 密钥，/ads generate 和 /ads photoshoot 会显示设置说明并退出；绝不会静默失败。

行业识别

根据广告账户信号识别业务类型：

• SaaS：trial_start/demo_request 事件、定价页面定向、较长的归因窗口
• 电商：购买事件、产品目录/Feed、Shopping/PMax 广告系列
• 本地服务：电话附加信息、位置定向、到店访问、路线指引事件
• B2B 企业：LinkedIn Ads 已启用、ABM 名单、较高的 CPA 容忍度（$50+）、较长的销售周期
• 信息产品：网络研讨会/课程漏斗、潜在客户开发表单、低价优惠
• 移动应用：应用安装广告系列、应用内事件、深度链接
• 房地产：房源 Feed、房产专属落地页、以地理位置为主的定向
• 医疗保健：HIPAA 合规标记、医疗保健专属广告政策
• 金融：已声明特殊广告类别、金融产品合规
• 代理商：多个客户账户、需要白标报告

质量门槛

硬性规则（绝不可违反）：

• 未启用智能出价时，绝不建议使用广泛匹配（Google）
• 3 倍止损规则：标记 CPA 超过目标值 3 倍的任何广告组/广告系列，以便暂停
• 预算充足性：Meta 每个广告组的预算 ≥ CPA 的 5 倍，TikTok 每个广告组的预算 ≥ CPA 的 50 倍
• 学习阶段：学习阶段进行中时，绝不建议编辑
• 合规性：务必检查住房/就业/信贷/金融相关的特殊广告类别
• 创意：绝不在 TikTok 上投放静音视频广告（该平台要求开启声音）
• 归因：默认使用 7 天点击 / 1 天浏览（Meta）、数据驱动归因（Google）
• Andromeda 创意多样性：标记创意素材少于 10 个真正不同素材的 Meta 账户
• 隐私基础设施门槛：在提出优化建议前，务必核实追踪技术栈（Consent Mode V2、CAPI、Events API、AdAttributionKit）
• PDF 报告质量门槛：通过 /ads report 生成报告时，务必先使用 scripts/generate_report.py 和 --check。报告必须满足以下要求：布局整洁、元素不重叠；页边距适当（0.75in）；表格单元格自动换行（无内容截断）；所有图表/图像尺寸均在页面边界内；包含页码和章节分隔线；每个可视化元素都有说明文字；没有空白章节。先运行 --check，再使用 --output；交付 PDF 前修复所有警告

参考文件

根据需要按需加载；请勿在启动时全部加载。

**路径解析：**所有参考文件均安装在 ~/.claude/skills/ads/references/。 当子技能或 Agent 引用 ads/references/*.md 时，请解析为 ~/.claude/skills/ads/references/*.md。

• references/audit-methodology.md：通用的 7 步审计流程，所有平台技能都委托使用。审计框架、检查 ID 规范、MCP 优先规则以及输出契约参考的唯一真实来源。
• references/audit-output-schema.json：每个 audit-* Agent 都必须输出的规范 JSON 架构。编排器会在汇总跨平台得分前根据此架构进行验证。新集成须符合此契约。
• references/profile-schema.json：~/.claude-ads/profile.json 的架构 — 由 /ads start 写入并由每条命令读取的持久化用户上下文。
• references/audit-history-schema.json：~/.claude-ads/history/index.json 的架构 — /ads next 读取此审计日志以检测回归。
• references/setup-meta.md / setup-google.md / setup-tiktok.md：OAuth + MCP + 手动连接的分步指南，由 /ads start 的 C 阶段加载。
• references/setup-zernio.md / setup-meta-developers.md：可选集成的账户创建指南。
• references/scoring-system.md：加权评分算法和评级阈值
• references/benchmarks.md：各平台的行业基准（CPC、CTR、CVR、ROAS）
• references/bidding-strategies.md：各平台的出价决策树
• references/budget-allocation.md：平台选择矩阵、扩量规则、MER
• references/platform-specs.md：所有平台的创意规格
• references/conversion-tracking.md：Pixel、CAPI、EMQ、ttclid 的实施
• references/compliance.md：监管要求、广告政策、隐私
• references/google-audit.md：80 项 Google Ads 审计清单（包括 YouTube 视频广告系列）
• references/meta-audit.md：50 项 Meta Ads 审计清单
• references/tiktok-audit.md：28 项 TikTok Ads 审计清单
• references/brand-dna-template.md：品牌 DNA 架构和提取指南
• references/image-providers.md：提供商配置（Gemini/OpenAI/Stability/Replicate）
• references/google-creative-specs.md：适用于 PMax/RSA/YouTube 的生成规格
• references/meta-creative-specs.md：Feed/Reels/Stories 规格 + 安全区域
• references/tiktok-creative-specs.md：仅限 9:16 + 安全区域叠加层
• references/gaql-notes.md：GAQL 字段兼容性、去重模式、筛选范围最佳实践
• references/voice-to-style.md：用于图像生成的品牌调性轴与视觉属性映射
• references/copy-frameworks.md：6 种广告文案框架（AIDA、PAS、BAB、4P、FAB、Star-Story-Solution）
• references/mcp-integration.md：规范的 MCP 集成模式 + 各平台 MCP 服务目录
• references/mcp-meta-integration.md：Meta MCP 检查项↔工具映射（新 MCP 集成的模板）

对于 MCP 并非首选方式的平台，审计 Agent 会读取由 scripts/api/<platform>_fetch.py 生成的 <platform>-data.json。 这些是纯标准库 API 适配器，涵盖 Meta、Google 和 TikTok。 各平台的 OAuth 设置指南见 scripts/api/README.md。

评分方法

广告健康度评分（0-100）

各平台使用 references/scoring-system.md 中的加权算法评分。 跨平台综合评分按预算占比加权：

Aggregate = Sum(Platform_Score x Platform_Budget_Share)

评级

评级	分数	所需行动
A	90-100	仅需进行少量优化
B	75-89	存在一些改进机会
C	60-74	有明显问题需要关注
D	40-59	存在严重问题
F	<40	需要紧急干预

优先级

• Critical：收入／数据损失风险（立即修复）
• High：严重影响性能（7 天内修复）
• Medium：优化机会（30 天内修复）
• Low：最佳实践，影响较小（列入待办）

子技能

此技能编排 19 项专用子技能：

1. ads-start：首次运行引导向导 — 收集上下文，逐个平台引导 OAuth/MCP 设置并进行验证，可选择注册 Zernio 和 Meta Developers，将资料保存到 ~/.claude-ads/profile.json
2. ads-audit：完整的多平台审计，通过并行委派检查 Meta / Google / TikTok
3. ads-next：持续辅导 — 根据近期审计和历史记录对快速见效项排序、检测回退，并可引导用户修复排名第 1 的问题
4. ads-google：深入分析 Google Ads（搜索、PMax、YouTube 视频广告系列 — 它们共用 Google Ads API）
5. ads-meta：深入分析 Meta Ads（FB、IG、Advantage+）— 已通过 MCP 接入 claude.ai Facebook
6. ads-tiktok：深入分析 TikTok Ads（Creative、Shop、Smart+、Symphony、GMV Max）
7. ads-creative：跨平台创意质量审计
8. ads-landing：广告广告系列的落地页质量分析
9. ads-budget：预算分配和出价策略
10. ads-plan：使用行业模板制定战略广告计划（v2.3.0 缩小范围后提供 8 个模板）
11. ads-competitor：竞争对手广告情报
12. ads-dna：从网站 URL 提取品牌 DNA
13. ads-create：广告系列概念、文案套件和创意简报
14. ads-generate：通过可插拔的服务提供商生成 AI 图像
15. ads-photoshoot：以 5 种专业风格拍摄产品照片
16. ads-update：根据最近 30 天的变更更新各平台参考资料
17. ads-math：PPC 财务计算器（CPA、ROAS、盈亏平衡、LTV:CAC、MER）
18. ads-test：A/B 测试设计（假设、样本量、统计显著性）
19. ads-publish：通过 Zernio 将创意发布到 14+ 个社交网络（前 2 个账号免费）

另外还有用于生成 PDF 交付物的 /ads report（在 scripts/generate_report.py 中实现，不包含 SKILL.md）。

子 Agent

用于完整审计期间的并行分析 — 每个平台对应一名深度专家：

• audit-google：Google Ads 80 项检查审计（G01-G74、G-PM*、G-AI*、G-DG*、G-CTV*、G-WS*、G-KW*、G-CT*、G-AD*）
• audit-meta：Meta Ads 50 项检查审计（M01-M40、M-AN*、M-AT*、M-CR*、M-ST*、M-IA*、M-TH*）— 已通过 MCP 接入
• audit-tiktok：TikTok Ads 28 项检查审计（T01-T25、T-SR*）— 将原先针对 TikTok 的 audit-creative/tracking/budget/compliance 整合为一个深度专家 Agent

创意工作流 Agent（保持不变）：

• creative-strategist：根据品牌资料和审计结果构思广告系列概念（Opus，maxTurns: 25）
• visual-designer：通过 generate_image.py 注入品牌元素并生成图像（Sonnet，maxTurns: 30）
• copy-writer：在平台限制范围内撰写标题、CTA 和正文（Sonnet，maxTurns: 20）
• format-adapter：验证素材尺寸并报告规格合规情况（Haiku，maxTurns: 15）

---

由 tododeia.com 维护 — Instagram @soyenriquerocha