Comprehensive paid advertising audit and optimization skill for Claude Code. Covers Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Search Ads with 190+ audit checks, industry-specific templates, and parallel subagent delegation.
- Installation
- Demo
- Quick Start
- Commands
- Features
- Architecture
- How It Analyzes Your Ads
- FAQ
- Requirements
- Uninstall
- Related Projects
- License
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh | bashirm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 | iexgit clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
./install.sh # Unix/macOS/Linux.\install.ps1 # Windows PowerShell
# Start Claude Code
claude
# Run a full multi-platform audit
/ads audit
# Deep analysis for a single platform
/ads google
/ads meta
/ads linkedin
# Strategic planning by business type
/ads plan saas
/ads plan ecommerce
/ads plan local-service
# Cross-platform creative audit
/ads creative
# Budget and bidding strategy review
/ads budget| Command | Description |
|---|---|
/ads audit |
Full multi-platform audit with parallel subagent delegation |
/ads google |
Google Ads deep analysis (Search, PMax, Display, YouTube, Demand Gen) |
/ads meta |
Meta Ads deep analysis (FB, IG, Advantage+ Shopping) |
/ads youtube |
YouTube Ads specific analysis (Skippable, Shorts, Demand Gen) |
/ads linkedin |
LinkedIn Ads deep analysis (B2B, Lead Gen, TLA) |
/ads tiktok |
TikTok Ads deep analysis (Creative, Shop, Smart+) |
/ads microsoft |
Microsoft/Bing Ads deep analysis (Copilot, Import validation) |
/ads creative |
Cross-platform creative quality audit and fatigue detection |
/ads landing |
Landing page quality assessment for ad campaigns |
/ads budget |
Budget allocation and bidding strategy review |
/ads apple |
Apple Search Ads (ASA) deep analysis (campaign structure, bids, MMP, TAP) |
/ads plan <type> |
Strategic ad plan with industry templates |
/ads competitor |
Competitor ad intelligence across all platforms |
Full Multi-Platform Audit
Spawns 6 parallel subagents to analyze your ad accounts simultaneously:
- audit-google — 74 checks across Search, PMax, Display, YouTube, Demand Gen
- audit-meta — 46 checks across Pixel/CAPI, Creative, Structure, Audience
- audit-creative — 21 cross-platform creative quality checks
- audit-tracking — 7 conversion tracking health checks
- audit-budget — 24 budget and bidding strategy checks
- audit-compliance — 18 compliance and regulatory checks
Generates a unified Ads Health Score (0-100) with prioritized action plan.
Strategic Ad Planning
Industry-specific templates with platform mix, campaign architecture, creative strategy, targeting, budget guidelines, and KPI targets.
Supported business types:
saas— Trial/demo focus, Google + LinkedIn primaryecommerce— Shopping/PMax, ROAS-focused, seasonallocal-service— Google Search + LSA, call tracking, geo radiusb2b-enterprise— LinkedIn ABM, long sales cycle, pipeline metricsinfo-products— Meta + YouTube, webinar/VSL funnelsmobile-app— Meta + Google UAC, MMP required, LTV:CPIreal-estate— Special Ad Category (housing), buyer/seller campaignshealthcare— HIPAA compliance, LegitScript, restricted targetingfinance— Special Ad Category (credit), required disclosuresagency— Multi-client management, reporting frameworkgeneric— Universal template with platform selection questionnaire
Comprehensive coverage across all platforms with weighted severity scoring:
| Platform | Checks | Key Areas |
|---|---|---|
| Google Ads | 74 | Search, PMax, Display, YouTube, Demand Gen |
| Meta Ads | 46 | Pixel/CAPI, Creative, Structure, Audience |
| LinkedIn Ads | 25 | B2B targeting, TLA, Lead Gen forms |
| TikTok Ads | 25 | Creative-first, Smart+, TikTok Shop |
| Microsoft Ads | 20 | Google import, Copilot, MSAN |
| Apple Search Ads | 35 | Campaign structure, bids, Creative Sets, MMP, TAP placements |
Weighted scoring algorithm with severity multipliers:
| Grade | Score | Action Required |
|---|---|---|
| A | 90-100 | Minor optimizations only |
| B | 75-89 | Some improvement opportunities |
| C | 60-74 | Notable issues need attention |
| D | 40-59 | Significant problems present |
| F | <40 | Urgent intervention required |
Auto-detects business type from ad account signals (product feeds, conversion events, platform mix, targeting patterns) and loads industry-specific benchmarks and templates.
Hard rules enforced during every audit:
- Never recommend Broad Match without Smart Bidding (Google)
- 3x Kill Rule: flag CPA >3x target for immediate pause
- Budget sufficiency: Meta ≥5x CPA/ad set, TikTok ≥50x CPA/ad group
- Learning phase protection: no edits during active learning
- Compliance: auto-check Special Ad Categories (housing/credit/finance)
12 built-in reference files with 2026-current benchmarks, bidding decision trees, platform specifications, compliance requirements, and conversion tracking implementation guides.
~/.claude/skills/ads/ # Main orchestrator
~/.claude/skills/ads/references/ # 12 RAG reference files
~/.claude/skills/ads-*/ # 13 sub-skills
~/.claude/skills/ads-plan/assets/ # 11 industry templates
~/.claude/agents/audit-*.md # 6 parallel audit agents
- Orchestrator (
/ads) routes commands to specialized sub-skills - Sub-skills provide deep single-domain analysis with structured output
- Agents run in parallel during full audits for maximum speed
- References load on-demand (RAG pattern) — only what's needed per analysis
- Templates provide industry-specific strategy frameworks
Claude Ads works with data you provide — exports, screenshots, or pasted metrics from your ad platform dashboards. It does not connect to any ad platform API automatically.
To get accurate, account-specific recommendations:
- Export your account data (last 30 days recommended)
- Run the relevant command:
/ads google,/ads audit, etc. - Claude will ask for your industry and budget context first — provide these for relevant benchmarks
- Paste or share your data when prompted
For direct API access without manual exports, install the Google Ads MCP alongside Claude Ads. This MCP server connects Claude directly to your Google Ads account via the API.
Can Claude Ads log into my ad manager automatically? No. Claude Ads analyzes data you provide (exports, screenshots, or pasted metrics). It doesn't connect to ad platforms automatically. See the Live Data Integration section above for Google Ads API access via MCP.
Does it use real account data or generic benchmarks? Benchmarks are based on industry research (WordStream, Triple Whale, etc.) covering 16,000+ campaigns. They're averages — your results will vary by industry, budget level, and account maturity. Always provide your industry and monthly spend when running audits for the most relevant comparisons.
Is ad posting or campaign creation still manual? Yes. Claude Ads is an audit and strategy tool. It finds issues, recommends fixes, and builds campaign plans — but creating, editing, or posting ads remains manual in your ad platform.
Why do some recommendations seem off for my account size?
Benchmarks and best practices differ significantly between a $500/month account and a $50k/month account. Always tell Claude your budget upfront: "I spend $2k/month on Google Ads for a local plumbing business" gives much better results than running /ads google without context.
Does it support [platform] ads? Currently supported: Google, Meta (Facebook/Instagram), YouTube, LinkedIn, TikTok, Microsoft/Bing, and Apple Search Ads. Pinterest and other platforms are on the roadmap.
- Claude Code CLI
- Python 3.10+ with Playwright (optional, for live landing page analysis)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.sh | bashirm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.ps1 | iex- Claude SEO — Comprehensive SEO analysis skill for Claude Code
MIT License - see LICENSE for details.
Built for Claude Code by @AgriciDaniel
