# Claude Ads: AI-Powered Paid Advertising Audit for Claude Code

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/agricidaniel-claude-ads
Generated for open source discovery and AI-assisted research.

Claude Ads is an AI-powered skill for Claude Code designed to automate comprehensive paid advertising audits. It performs over 250 checks across major ad platforms, providing a weighted health score, prioritized action plans, and AI creative generation. This tool drastically reduces the time and cost associated with manual ad account analysis.

GitHub: https://github.com/AgriciDaniel/claude-ads
OSRepos URL: https://osrepos.com/repo/agricidaniel-claude-ads

## Summary

Claude Ads is an AI-powered skill for Claude Code designed to automate comprehensive paid advertising audits. It performs over 250 checks across major ad platforms, providing a weighted health score, prioritized action plans, and AI creative generation. This tool drastically reduces the time and cost associated with manual ad account analysis.

## Topics

- ai
- ai-marketing
- claude-code
- marketing-automation
- python
- paid-ads
- audit
- open-source

## Repository Information

Last analyzed by OSRepos: Sun Jun 14 2026 17:31:47 GMT+0100 (Western European Summer Time)
Detail views: 3
GitHub clicks: 4

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Claude Ads is an innovative, AI-powered skill for Claude Code designed to revolutionize paid advertising audits and optimization. This comprehensive tool performs over 250 checks across major ad platforms, including Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, and Amazon Ads. It provides a weighted Ads Health Score, a prioritized action plan, and even AI creative generation, drastically reducing the time and cost associated with manual ad account analysis.

Built for PPC agencies, in-house marketers, and freelance ad consultants, Claude Ads can complete an audit in 10-15 minutes that would typically take a senior PPC specialist 4-6 hours. It runs locally, is deterministic, and is MIT-licensed, ensuring privacy and flexibility.

## Installation

To get started with Claude Ads, you can choose from several installation methods. We will focus on the public open-source version ([AgriciDaniel/claude-ads](https://github.com/AgriciDaniel/claude-ads){:target="_blank"}).

### 1. Plugin Install (Claude Code, Recommended)

This method registers Claude Ads as a native plugin with auto-updates and version tracking.

shell
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@agricidaniel-claude-ads


### 2. One-Command Install (Unix/macOS/Linux)

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


### 3. One-Command Install (Windows PowerShell)

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


### Requirements

*   Claude Code CLI
*   Python 3.10+ (with Playwright optional, for live landing page analysis)
*   reportlab (optional, for PDF report generation via `/ads report`)

## Examples

Claude Ads offers a range of commands for various audit and planning tasks. Here are some quick start examples:

### Run a Full Multi-Platform Audit

bash
# Start Claude Code
claude

# Run a full multi-platform audit
/ads audit


### Sample Output for `/ads audit`


{
  "ads_health_score": 73,
  "grade": "C",
  "audit_date": "2026-05-18",
  "platforms": {
    "google_ads": { "score": 78, "grade": "B", "checks_run": 80, "critical": 2, "high": 5 },
    "meta_ads":   { "score": 64, "grade": "C", "checks_run": 50, "critical": 4, "high": 7 },
    "linkedin":   { "score": 81, "grade": "B", "checks_run": 27, "critical": 0, "high": 3 }
  },
  "top_findings": [
    {
      "id": "M-AND-01",
      "severity": "critical",
      "platform": "meta",
      "title": "Andromeda creative similarity > 60%: retrieval suppression risk",
      "impact": "Estimated 20-35% reach loss; 4 ad sets affected",
      "action": "Replace 7 near-duplicate creatives with concept-diverse variants",
      "owner": "creative",
      "eta_days": 7
    },
    {
      "id": "G-AIM-03",
      "severity": "high",
      "platform": "google",
      "title": "AI Max enabled without negative keyword discipline",
      "impact": "Wasted spend ~$1,400/mo on irrelevant queries",
      "action": "Build negative list from 30d search term report",
      "owner": "search",
      "eta_days": 2
    }
  ],
  "quick_wins": [
    "Enable Consent Mode V2 (Privacy Sandbox compatible, ~1 hr)",
    "Pause 3 ad groups failing 3x Kill Rule (saves ~$420/mo)"
  ]
}


### Deep Analysis for a Single Platform

bash
/ads google
/ads meta
/ads linkedin


### Strategic Planning by Business Type

bash
/ads plan saas
/ads plan ecommerce
/ads plan local-service


### Cross-Platform Creative Audit

bash
/ads creative


## Why Use Claude Ads?

Claude Ads offers significant advantages over traditional manual audits, agency engagements, or commercial PPC audit tools:

*   **Unmatched Efficiency**: Transform a 4-6 hour manual audit into a 10-15 minute automated process. This allows agencies to audit accounts weekly instead of quarterly, and in-house marketers to gain a second pair of eyes before executive reviews.
*   **Comprehensive and Up-to-Date Coverage**: With over 250 checks, Claude Ads identifies critical issues across a wide range of platforms. It stays current with the latest platform changes, such as Meta's Andromeda, Google's AI Max, and Apple's AdAttributionKit, often outpacing commercial tools.
*   **Actionable Insights**: Receive a clear Ads Health Score (0-100) and a prioritized action plan, including critical findings and quick wins. This helps in anchoring client engagements and proactively addressing performance issues.
*   **Cost-Effective**: As an open-source skill, Claude Ads is free to use (requiring a Claude Code subscription), offering a powerful alternative to expensive agency retainers or monthly commercial tool subscriptions.
*   **Privacy and Control**: All analysis runs locally on your machine, ensuring your ad account data never leaves your environment. Being MIT-licensed, it offers full transparency and the ability to customize audit checks to your specific needs.
*   **Strategic Planning and Creative Generation**: Beyond auditing, Claude Ads provides industry-specific strategic ad plans and an AI-powered creative pipeline to generate campaign concepts, copy briefs, and even ad images.

## Links

*   **GitHub Repository**: [AgriciDaniel/claude-ads](https://github.com/AgriciDaniel/claude-ads){:target="_blank"}
*   **Maintainer's Blog**: [Agrici Daniel's Blog](https://agricidaniel.com/blog){:target="_blank"}
*   **AI Marketing Hub (Free Community)**: [AI Marketing Hub](https://www.skool.com/ai-marketing-hub){:target="_blank"}