# 付费广告审计工具

`广告审计` `Claude Code` `Google Ads` `Meta Ads` `营销优化`

<p align="center">
  <img src="assets/banner.png" alt="Claude Ads：Claude Code 的付费广告审计技能" width="100%">
</p>

# Claude Ads：Claude Code 的付费广告审计技能

面向 Claude Code 的全面付费广告审计与优化技能。涵盖 Google Ads、Meta Ads、YouTube Ads、LinkedIn Ads、TikTok Ads、Microsoft Ads 及 Apple Search Ads，提供 190+ 项审计检查、行业专属模板以及并行子代理委托执行。

[![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://claude.ai/claude-code)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Version](https://img.shields.io/github/v/release/AgriciDaniel/claude-ads)](https://github.com/AgriciDaniel/claude-ads/releases)
[![CI](https://img.shields.io/github/actions/workflow/status/AgriciDaniel/claude-ads/ci.yml?branch=main&label=CI)](https://github.com/AgriciDaniel/claude-ads/actions)

> **博客：** [阅读完整的广告审计详解](https://agricidaniel.com/blog/claude-code-ad-agency)

## 目录

- [安装](#安装)
- [演示](#演示)
- [快速开始](#快速开始)
- [命令](#命令)
- [功能特性](#功能特性)
- [架构](#架构)
- [如何分析您的广告](#如何分析您的广告)
- [常见问题](#常见问题)
- [依赖要求](#依赖要求)
- [卸载](#卸载)
- [相关项目](#相关项目)
- [许可证](#许可证)

## 安装

### 一键安装（Unix/macOS/Linux）

```bash
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh | bash
```

### 一键安装（Windows PowerShell）

```powershell
irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 | iex
```

### 手动安装

```bash
git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
./install.sh          # Unix/macOS/Linux
```

```powershell
.\install.ps1         # Windows PowerShell
```

## 演示

<p align="center">
  <img src="assets/demo.gif" alt="Claude Ads 演示" width="100%">
</p>

## 快速开始

```bash
# 启动 Claude Code
claude

# 执行完整的多平台审计
/ads audit

# 对单一平台进行深度分析
/ads google
/ads meta
/ads linkedin

# 按业务类型进行战略规划
/ads plan saas
/ads plan ecommerce
/ads plan local-service

# 跨平台素材审计
/ads creative

# 预算与出价策略审查
/ads budget
```

## 命令

| 命令 | 描述 |
|---------|-------------|
| `/ads audit` | 通过并行子代理委托执行完整的多平台审计 |
| `/ads google` | Google Ads 深度分析（搜索、PMax、展示、YouTube、Demand Gen） |
| `/ads meta` | Meta Ads 深度分析（FB、IG、Advantage+ 购物） |
| `/ads youtube` | YouTube Ads 专项分析（可跳过广告、Shorts、Demand Gen） |
| `/ads linkedin` | LinkedIn Ads 深度分析（B2B、潜在客户开发、TLA） |
| `/ads tiktok` | TikTok Ads 深度分析（创意、Shop、Smart+） |
| `/ads microsoft` | Microsoft/Bing Ads 深度分析（Copilot、导入校验） |
| `/ads creative` | 跨平台素材质量审计与疲劳度检测 |
| `/ads landing` | 广告落地页质量评估 |
| `/ads budget` | 预算分配与出价策略审查 |
| `/ads apple` | Apple Search Ads（ASA）深度分析（广告系列结构、出价、MMP、TAP 版位） |
| `/ads plan <类型>` | 含行业模板的战略广告计划 |
| `/ads competitor` | 跨平台竞争对手广告情报分析 |

### `/ads audit`
**完整多平台审计**

启动 6 个并行子代理，同时分析您的广告账户：
- **audit-google**：跨搜索、PMax、展示、YouTube、Demand Gen 的 74 项检查
- **audit-meta**：跨 Pixel/CAPI、素材、结构、受众的 46 项检查
- **audit-creative**：21 项跨平台素材质量检查
- **audit-tracking**：7 项转化追踪健康度检查
- **audit-budget**：24 项预算与出价策略检查
- **audit-compliance**：18 项合规性与法规检查

生成统一的**广告健康分（0-100）**及优先级行动计划。

### `/ads plan <业务类型>`
**战略广告规划**

提供行业专属模板，涵盖平台组合、广告系列架构、素材策略、定向方式、预算指导方针及 KPI 目标。

**支持的业务类型：**
- `saas`：以试用/演示为重点，以 Google + LinkedIn 为主
- `ecommerce`：购物/PMax，以 ROAS 为导向，关注季节性
- `local-service`：Google 搜索 + LSA，通话追踪，地理半径定向
- `b2b-enterprise`：LinkedIn ABM，长销售周期，管道指标
- `info-products`：Meta + YouTube，网络研讨会/VSL 漏斗
- `mobile-app`：Meta + Google UAC，必须使用 MMP，LTV:CPI
- `real-estate`：特殊广告类别（住房），买家/卖家广告系列
- `healthcare`：HIPAA 合规，LegitScript，受限定向
- `finance`：特殊广告类别（信贷），必要披露声明
- `agency`：多客户管理，报告框架
- `generic`：通用模板，含平台选择问卷

## 功能特性

### 190+ 项审计检查
覆盖所有平台的全面检查，配以加权严重性评分：

| 平台 | 检查项数 | 核心领域 |
|----------|--------|-----------|
| Google Ads | 74 | 搜索、PMax、展示、YouTube、Demand Gen |
| Meta Ads | 46 | Pixel/CAPI、素材、结构、受众 |
| LinkedIn Ads | 25 | B2B 定向、TLA、潜在客户开发表单 |
| TikTok Ads | 25 | 素材优先、Smart+、TikTok Shop |
| Microsoft Ads | 20 | Google 导入、Copilot、MSAN |
| Apple Search Ads | 35 | 广告系列结构、出价、创意集、MMP、TAP 版位 |

### 广告健康分（0-100）
含严重性倍数的加权评分算法：

| 等级 | 分数 | 所需操作 |
|-------|-------|-----------------|
| A | 90-100 | 仅需小幅优化 |
| B | 75-89 | 存在一些改进空间 |
| C | 60-74 | 需关注明显问题 |
| D | 40-59 | 存在重大问题 |
| F | <40 | 需立即紧急干预 |

### 行业自动识别
从广告账户信号（商品 Feed、转化事件、平台组合、定向模式）自动识别业务类型，并加载行业专属基准与模板。

### 质量门禁
每次审计强制执行的硬性规则：
- 不得在没有智能出价的情况下推荐广泛匹配（Google）
- 3 倍淘汰规则：CPA 超过目标 3 倍时立即标记暂停
- 预算充足性：Meta 每广告组 ≥5 倍 CPA，TikTok 每广告组 ≥50 倍 CPA
- 学习期保护：学习期内禁止编辑
- 合规性：自动检查特殊广告类别（住房/信贷/金融）

### 参考数据
23 个内置参考文件，包含 2026 年最新基准数据、出价决策树、平台规范、合规要求及转化追踪实施指南。

## 架构

```
~/.claude/skills/ads/              # 主编排器
~/.claude/skills/ads/references/   # 23 个 RAG 参考文件
~/.claude/skills/ads-*/            # 17 个子技能
~/.claude/skills/ads-plan/assets/  # 11 个行业模板
~/.claude/agents/                  # 10 个代理（6 个审计 + 4 个素材）
```

### 工作原理

1. **编排器**（`/ads`）将命令路由至专属子技能
2. **子技能**提供单一领域的深度分析与结构化输出
3. **代理**在完整审计时并行运行，以获得最快速度
4. **参考文件**按需加载（RAG 模式），每次分析仅加载所需内容
5. **模板**提供行业专属战略框架

## 如何分析您的广告

**Claude Ads 基于您提供的数据运行**，包括从广告平台控制台导出的文件、截图或粘贴的指标数据。它不会自动连接任何广告平台 API。

**要获得准确的账户专属建议：**
1. 导出您的账户数据（建议选取最近 30 天）
2. 运行相应命令：`/ads google`、`/ads audit` 等
3. Claude 会首先询问您的行业和预算情况——请提供这些信息以获取相关基准
4. 在提示时粘贴或分享您的数据

### 实时数据集成（可选）

如需在无需手动导出的情况下直接访问 API，可在 Claude Ads 的基础上安装 [Google Ads MCP](https://github.com/googleads/google-ads-mcp)。该 MCP 服务器可通过 API 将 Claude 直接连接至您的 Google Ads 账户。

## 常见问题

**Claude Ads 能自动登录我的广告管理平台吗？**
不能。Claude Ads 分析您提供的数据（导出文件、截图或粘贴的指标）。它不会自动连接广告平台。如需 Google Ads API 访问，请参阅上方的实时数据集成章节。

**它使用的是真实账户数据还是通用基准？**
基准数据来源于行业研究（WordStream、Triple Whale 等），覆盖 16,000 多个广告系列。这些均为平均值，您的实际结果将因行业、预算规模和账户成熟度而有所不同。运行审计时请务必提供您的行业和月度花费，以获得最相关的对比数据。

**广告投放或广告系列创建仍需手动操作吗？**
是的。Claude Ads 是一款审计与策略工具。它负责发现问题、提供修复建议并制定广告系列计划，但广告的创建、编辑或投放仍需在您的广告平台中手动操作。

**为什么某些建议对我的账户规模来说似乎不太合适？**
月花费 500 美元的账户与月花费 5 万美元的账户，其最佳实践和基准存在显著差异。请务必在开始时告知 Claude 您的预算：例如 *"我为本地水管业务每月在 Google Ads 上花费 2,000 美元"*，比直接运行 `/ads google` 而不提供背景信息的效果要好得多。

**它支持 [某平台] 的广告吗？**
目前支持：Google、Meta（Facebook/Instagram）、YouTube、LinkedIn、TikTok、Microsoft/Bing 以及 Apple Search Ads。Pinterest 及其他平台已列入路线图。

## 依赖要求

- Claude Code CLI
- Python 3.10+，含 Playwright（可选，用于实时落地页分析）

## 卸载

### Unix/macOS/Linux

```bash
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.sh | bash
```

### Windows PowerShell

```powershell
irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.ps1 | iex
```

## 相关项目

- [Claude SEO](https://github.com/AgriciDaniel/claude-seo)——面向 Claude Code 的全面 SEO 分析技能

## 许可证

MIT 许可证——详见 [LICENSE](LICENSE)。

---

由 [@AgriciDaniel](https://github.com/AgriciDaniel) 为 Claude Code 构建