Skip to content

jayhaz/claude-ads

 
 

Repository files navigation

Claude Ads

Claude Ads

https://www.youtube.com/watch?v=Kf7ejOtl5KU

Comprehensive paid advertising audit and optimization skill for Claude Code. Covers Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, and Microsoft Ads with 190 audit checks, industry-specific templates, and parallel subagent delegation.

Claude Code Skill License: MIT

Installation

One-Command Install (Unix/macOS/Linux)

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

One-Command Install (Windows PowerShell)

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

Manual Install

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
./install.sh          # Unix/macOS/Linux
.\install.ps1         # Windows PowerShell

Demo

Claude Ads Demo

Quick Start

# 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

Commands

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 plan <type> Strategic ad plan with industry templates
/ads competitor Competitor ad intelligence across all platforms

/ads audit

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.

/ads plan <business-type>

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 primary
  • ecommerce — Shopping/PMax, ROAS-focused, seasonal
  • local-service — Google Search + LSA, call tracking, geo radius
  • b2b-enterprise — LinkedIn ABM, long sales cycle, pipeline metrics
  • info-products — Meta + YouTube, webinar/VSL funnels
  • mobile-app — Meta + Google UAC, MMP required, LTV:CPI
  • real-estate — Special Ad Category (housing), buyer/seller campaigns
  • healthcare — HIPAA compliance, LegitScript, restricted targeting
  • finance — Special Ad Category (credit), required disclosures
  • agency — Multi-client management, reporting framework
  • generic — Universal template with platform selection questionnaire

Features

190 Audit Checks

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

Ads Health Score (0-100)

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

Industry Detection

Auto-detects business type from ad account signals (product feeds, conversion events, platform mix, targeting patterns) and loads industry-specific benchmarks and templates.

Quality Gates

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)

Reference Data

12 built-in reference files with 2026-current benchmarks, bidding decision trees, platform specifications, compliance requirements, and conversion tracking implementation guides.

Architecture

~/.claude/skills/ads/              # Main orchestrator
~/.claude/skills/ads/references/   # 12 RAG reference files
~/.claude/skills/ads-*/            # 12 sub-skills
~/.claude/skills/ads-plan/assets/  # 11 industry templates
~/.claude/agents/audit-*.md         # 6 parallel audit agents

How It Works

  1. Orchestrator (/ads) routes commands to specialized sub-skills
  2. Sub-skills provide deep single-domain analysis with structured output
  3. Agents run in parallel during full audits for maximum speed
  4. References load on-demand (RAG pattern) — only what's needed per analysis
  5. Templates provide industry-specific strategy frameworks

Requirements

  • Claude Code CLI
  • Python 3.10+ with Playwright (optional, for live landing page analysis)

Uninstall

Unix/macOS/Linux

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

Windows PowerShell

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

Related Projects

  • Claude SEO — Comprehensive SEO analysis skill for Claude Code

License

MIT License - see LICENSE for details.


Built for Claude Code by @AgriciDaniel

About

Comprehensive paid advertising audit & optimization skill for Claude Code. 186 checks across Google, Meta, YouTube, LinkedIn, TikTok & Microsoft Ads with weighted scoring, parallel agents, and industry templates.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 84.5%
  • Shell 15.5%