# claude-ads

> Comprehensive paid advertising audit & optimization skill for Claude Code. 225+ checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft & Apple Search Ads with weighted scoring, parallel agen

- **URL**: https://www.freshcrate.ai/projects/claude-ads
- **Author**: AgriciDaniel
- **Category**: RAG & Memory
- **Latest version**: `v1.7.1` (2026-05-18)
- **License**: MIT
- **Source**: https://github.com/AgriciDaniel/claude-ads
- **Homepage**: https://agricidaniel.com/blog/claude-code-ad-agency
- **Language**: Python
- **GitHub**: 2,819 stars, 470 forks
- **Registry**: github
- **Tags**: `ai`, `ai-marketing`, `claude-code`, `claude-code-skill`, `marketing-automation`, `open-source`, `python`

## Description

Comprehensive paid advertising audit & optimization skill for Claude Code. 225+ checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft & Apple Search Ads with weighted scoring, parallel agents, industry templates, and AI creative generation.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.7.1` | 2026-05-18 | High | **Post-v1.7.0 polish wave.** The release that elevated the skill to SSS+ tier across README, branding, banner, dual-repo positioning, and primary-source citation discipline. Docs + assets + branding + housekeeping; no new sub-skills, no new agents, no script behavior changes.  ### Added - **Animated SVG banner** (`assets/banner.svg`) — 13.9 KB optimized, 22 SMIL animations, vector-crisp at any zoom, screen-reader friendly with `role="img"` + `<title>`/`<desc>` - **Branding kit** (`branding/banne |
| `v1.5.1` | 2026-04-14 | High | Security hardening release. Full 8-agent cybersecurity audit, 10 fixes applied, score improved from 62/100 to 90/100.  ### SSRF Protection  - New shared validation module (`scripts/url_utils.py`) blocks requests to private/internal IPs - All 3 URL-handling scripts (fetch_page, analyze_landing, capture_screenshot) now use it - IPv4 and IPv6 private ranges blocked, including cloud metadata (169.254.x.x) and CGNAT (100.64.x.x) - DNS resolution failures now reject the URL instead of passing through |
| `v1.5.0` | 2026-04-13 | High | ![claude-ads v1.5.0](https://github.com/AgriciDaniel/claude-ads/releases/download/v1.5.0/claude-ads-v1-5-cover.png)  ## What's New  ### 22 New Audit Checks (190 to 212 in reference files, 250+ total)  **Google Ads (74 to 80):** AI Max for Search evaluation, Demand Gen image assets, VAC migration status, Demand Gen frequency cap loss, CTV Floodlight limitation, PMax negative keywords.  **Meta Ads (46 to 50):** Andromeda creative diversity (Similarity Score >60% = suppression), post-Jan 2026 attri |
| `v1.4.0` | 2026-04-10 | High | ## What's New  ### Banana-Claude Integration Replaced `generate_image.py` with [banana-claude](https://github.com/AgriciDaniel/banana-claude) (v1.4.1) as the default image generation provider. Uses MCP tools (`gemini_generate_image`, `set_aspect_ratio`), 5-component prompt formula, 9 domain modes, and brand presets.  ### Creative Pipeline Overhaul - **Visual consistency anchoring**: visual-designer generates a "hero" image first and passes it as a style reference to all subsequent campaign asset |
| `v1.3.0` | 2026-04-01 | Medium | ## What's New  ### GAQL Audit Accuracy Fixes (~600 false positives eliminated) Upstreamed 10 audit accuracy improvements discovered by the akarls-web community fork: - **G03**: False positives from zero-impression keywords, paused ad groups, match type duplication, stopword-only keywords (~18% reduction) - **G04**: Multi-location campaign structures no longer over-count objectives - **G12**: Search Partners logic corrected (flag OFF, not ON) - **G16/G-WS1**: Wasted spend threshold raised to >$10 |
| `v1.0.0` | 2026-03-13 | Low | # Claude Ads v1.0.0  Comprehensive paid advertising audit & optimization skill for [Claude Code](https://claude.ai/claude-code).  ## Quick Install  **Unix/macOS/Linux:** ```bash curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh \| bash ```  **Windows PowerShell:** ```powershell irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 \| iex ```  ## Highlights  ### 186 Audit Checks \| Platform \| Checks \| Key Areas \| \|----------\|--------\|------ |
| `v1.2.0` | 2026-03-12 | Low | ## What's New  ### Added - **Apple Search Ads sub-skill** (`/ads apple`): 35 checks across campaign structure (BOFU/MOFU/Search Match isolation), bid health (CPT vs install rate, CPA Goals), Creative Sets (Custom Product Pages), MMP attribution (AppsFlyer/Adjust/SKAdNetwork), budget pacing, TAP placement coverage (Today/Search/Product Pages), and goal CPA benchmarks by app category and country tier - **Context Intake**: Claude now asks for industry, monthly spend, primary goal, and active platfo |

## Dependency audit

- **Score**: 80/100
- **Total deps**: 6
- **Resolved**: 3
- **Unresolved**: 3
- **License conflicts**: 0
- **Warnings**: 5
- **Scanned**: 2026-06-01

## Citation

- HTML: https://www.freshcrate.ai/projects/claude-ads
- Markdown: https://www.freshcrate.ai/projects/claude-ads.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/claude-ads/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._