claude-ads — What is it?

AgriciDaniel/claude-ads is a comprehensive paid advertising audit and optimization tool for Claude Code, offering 250+ checks across multiple platforms with AI-driven creative generation.

⭐ 5,437 Stars 🍴 813 Forks Python MIT Author: AgriciDaniel
Source: README View on GitHub →

Why it matters

This project is gaining attention due to its comprehensive approach to paid advertising audit and optimization, addressing the pain points of complex multi-platform advertising management. Its unique technical choices, such as parallel subagent delegation and AI creative generation, stand out in the market.

Source: Synthesis of README and project traits

Core Features

250+ Audit Checks

Comprehensive coverage of audit checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads, with weighted severity scoring.

Source: README Features
Parallel Subagent Delegation

Spawns parallel subagents to analyze ad accounts simultaneously, improving efficiency and speed.

Source: README Commands /ads audit
Industry Templates

Industry-specific templates for platform mix, campaign architecture, creative strategy, targeting, budget guidelines, and KPI targets.

Source: README Commands /ads plan
AI Creative Generation

AI-powered creative generation with specialized agents for different platforms.

Source: README Features Creative Pipeline

Architecture

The architecture is modular, with separate modules for each platform and functionality. It uses parallel processing for efficiency and employs AI for creative generation and analysis. Key technical decisions include the use of Claude Code for integration and Python for scripting.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) requests playwright urllib3 Pillow reportlab 250+ Audit Checks Parallel Subagent DelegationParallel Subagent D… Industry Templates AI Creative GenerationAI Creative Generat… claude-ads Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguagePythonFrameworkClaude Code
requestsplaywrighturllib3Pillowreportlabmatplotlib
Local machine via Claude Code
Source: Dependency files + code tree

Quick Start

Plugin Install: /plugin marketplace add AgriciDaniel/claude-ads /plugin install claude-ads@agricidaniel-claude-ads 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)
Source: README Installation/Quick Start

Use Cases

This project is for digital marketers, advertising agencies, and businesses managing multi-platform paid advertising campaigns. It is useful for audit and optimization of Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads. Specific problems it solves include complex multi-platform management, creative generation, and strategic planning.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Comprehensive audit and optimization capabilities across multiple platforms.
  • Strength 2: AI-driven creative generation for improved ad performance.
  • Strength 3: Industry-specific templates for strategic planning.

Limitations

  • Limitation 1: Requires Claude Code for integration.
  • Limitation 2: May have a steep learning curve for new users.
Source: Synthesis of README, code structure and dependencies

Latest Release

v1.5.1 (2026-04-14): Security Hardening v1.5.0 (2026-04-13): 250+ Audit Checks, PDF Reports, Security Hardening v1.4.0 (2026-04-10): Banana Integration, Creative Pipeline Overhaul, E-commerce Templates v1.3.0 (2026-04-01): GAQL Accuracy Fixes, Validation Gates, Marketplace Support

Source: GitHub Releases

Verdict

AgriciDaniel/claude-ads is a powerful tool for managing and optimizing multi-platform paid advertising campaigns. It is particularly suitable for teams and individuals who require a comprehensive, AI-driven solution for their advertising needs.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-23 00:35. Quality score: 85/100.

Data sources: README, GitHub API, dependency files