catalog/repos/agricidaniel--claude-ads.md

259 lines
10 KiB
Markdown
Raw Permalink Normal View History

2026-04-07 11:44:56 +08:00
# 付费广告审计工具
`广告审计` `Claude Code` `Google Ads` `Meta Ads` `营销优化`
<p align="center">
<img src="assets/banner.png" alt="Claude AdsClaude Code 的付费广告审计技能" width="100%">
</p>
# Claude AdsClaude 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 AdsASA深度分析广告系列结构、出价、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必须使用 MMPLTV: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 倍 CPATikTok 每广告组 ≥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、MetaFacebook/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 构建