/ Annuaire / Playground / claude-ads
● Communauté AgriciDaniel ⚡ Instantané

claude-ads

par AgriciDaniel · AgriciDaniel/claude-ads

Runs 250+ paid-ads audit checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple — with scoring, creative review, and PDF reports.

A Claude Code skill for paid-advertising audits and optimization. Feed it campaign exports or screenshots and it produces a weighted 0-100 Ads Health Score, platform-specific findings, creative quality review, privacy-infra verification (Consent Mode V2, CAPI, Events API), and a client-ready PDF. Parallel subagents run per-platform analyses simultaneously.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

claude-ads-skill.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-ads-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-ads-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-ads",
          "~/.claude/skills/claude-ads"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add claude-ads-skill -- git clone https://github.com/AgriciDaniel/claude-ads ~/.claude/skills/claude-ads

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : claude-ads

Audit a Google Ads account before taking it over

👤 Agencies onboarding a new paid-search client ⏱ ~45 min intermediate

Quand l'utiliser : You're bidding for the account and need to show concrete gaps in week one.

Prérequis
  • Exported account data or screenshots — Google Ads Editor export or the standard 'all campaigns' CSV
Déroulement
  1. Feed the skill the export
    Run the claude-ads skill on this Google Ads export. Focus on Search + PMax. Give me the health score and top 10 issues.✓ Copié
    → Score with breakdown by category (structure, bidding, creative, tracking)
  2. Drill into PMax specifically
    Now deep-dive PMax — asset quality, audience signals, brand-exclusion list. What's the quick-win?✓ Copié
    → Platform-specific findings with remediation priority
  3. Generate the PDF
    Export to a client PDF with the score dashboard on page 1 and the remediation roadmap at the end.✓ Copié
    → Polished PDF ready to send

Résultat : A deliverable audit that wins the pitch.

Pièges
  • Audit based on incomplete data gives wrong conclusions — Include 90 days of performance plus settings export, not just a screenshot

Verify Meta Advantage+ privacy infrastructure before iOS 18

👤 In-house paid-social managers ⏱ ~30 min advanced

Quand l'utiliser : Attribution is drifting and you suspect CAPI or Events API isn't firing cleanly.

Déroulement
  1. Run the privacy-infra check
    Use claude-ads to audit our Meta setup for CAPI completeness, event match quality, and Consent Mode V2.✓ Copié
    → Per-event pass/fail with remediation
  2. Get the fix plan
    Prioritize fixes by attribution-loss impact.✓ Copié
    → Ordered list tied to revenue impact

Résultat : A concrete privacy-infrastructure punch-list.

Pièges
  • Matching Match Quality fixes without GTM changes — The skill flags when GTM/server-side tag config is also required

Generate 10 new ad creative variants for a failing ad set

👤 Performance marketers in creative refresh ⏱ ~30 min intermediate

Quand l'utiliser : CPMs are climbing and your creatives are fatigued.

Déroulement
  1. Provide the winning ad + brief
    Here's our best-performing Meta ad. Use claude-ads creative agents to generate 10 variants that test different hooks.✓ Copié
    → 10 copy + visual-brief pairs, each with a stated hypothesis
  2. Score the variants
    Which 3 should we ship first based on policy safety and hypothesis strength?✓ Copié
    → Short list with reasoning

Résultat : A creative batch with clear hypotheses to test.

Pièges
  • Generated copy violates platform policy — The skill's compliance check catches most issues — but have a human final-check on regulated verticals

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

After creative-agents propose variants, generate image prompts for each

For each of the 10 creative variants, use Nano Banana to propose an image prompt.✓ Copié
claude-ads-skill + claude-seo-skill

Align paid landing pages with SEO best practices from /seo audit

Run /seo audit on the landing pages paid traffic is hitting, then cross-reference with claude-ads landing-page quality findings.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
Platform audit exported campaign data Full or partial account review 0
Ads Health Score audit results At the end of each audit 0
Privacy infrastructure check tag config or screenshots Attribution or policy review 0
Creative generation agents winning ad + brief Creative refresh 0
Financial modeling conversion rate, AOV, margin Budget planning 0

Coût et limites

Coût d'exécution

Quota d'API
None for the skill
Tokens par appel
Full audit: 15-40k tokens; single-platform: 5-10k
Monétaire
Free — skill is local; you still pay for the ad spend it's auditing
Astuce
Run platform-by-platform for ongoing clients; full-account audits are best for onboarding and quarterly reviews.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : No credentials — skill reads exports you paste in. Campaign data stays on your machine.
Sortie de données : None from the skill itself

Dépannage

Erreurs courantes et correctifs

Score seems too low/high for the account

Check the export completeness — missing conversion data skews the score.

Creative agents miss brand voice

Include a brand voice doc or 3 winning ads as style anchors in the prompt.

PDF export fails

The skill needs a markdown-to-PDF runtime; check the skill's setup section for the required dependency.

Alternatives

claude-ads vs autres

AlternativeQuand l'utiliserCompromis
Manual audits via platform UIsYou only manage one account and have timeThorough but slow; doesn't scale
claude-seo-skillYou need organic / technical SEO instead of paidDifferent side of the acquisition funnel

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills