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

259 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 付费广告审计工具
`广告审计` `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 访问请参阅上方的实时数据集成章节
**它使用的是真实账户数据还是通用基准?**
基准数据来源于行业研究WordStreamTriple Whale 覆盖 16,000 多个广告系列这些均为平均值您的实际结果将因行业预算规模和账户成熟度而有所不同运行审计时请务必提供您的行业和月度花费以获得最相关的对比数据
**广告投放或广告系列创建仍需手动操作吗?**
是的Claude Ads 是一款审计与策略工具它负责发现问题提供修复建议并制定广告系列计划但广告的创建编辑或投放仍需在您的广告平台中手动操作
**为什么某些建议对我的账户规模来说似乎不太合适?**
月花费 500 美元的账户与月花费 5 万美元的账户其最佳实践和基准存在显著差异请务必在开始时告知 Claude 您的预算例如 *"我为本地水管业务每月在 Google Ads 上花费 2,000 美元"*比直接运行 `/ads google` 而不提供背景信息的效果要好得多
**它支持 [某平台] 的广告吗?**
目前支持GoogleMetaFacebook/Instagram)、YouTubeLinkedInTikTokMicrosoft/Bing 以及 Apple Search AdsPinterest 及其他平台已列入路线图
## 依赖要求
- 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 构建