[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74045":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},74045,"claude-ads","AgriciDaniel\u002Fclaude-ads","AgriciDaniel","Comprehensive paid advertising audit & optimization skill for Claude Code. 250+ checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft & Apple Ads with weighted scoring, parallel agents, industry templates, and AI creative generation.","https:\u002F\u002Fagricidaniel.com\u002Fblog\u002Fclaude-code-ad-agency",null,"Python",5895,888,52,10,0,146,515,1166,438,114.85,"MIT License",false,"main",[26,27,28,29,30,31],"ai","ai-marketing","claude-code","claude-code-skill","marketing-automation","open-source","2026-06-12 04:01:12","\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fbanner.png\" alt=\"Claude Ads: Paid Advertising Audit Skill for Claude Code\" width=\"100%\">\n\u003C\u002Fp>\n\n# Claude Ads: Paid Advertising Audit Skill for Claude Code\n\nComprehensive paid advertising audit and optimization skill for Claude Code. Covers Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads with **250+ audit checks**, industry-specific templates, parallel subagent delegation, PPC financial modeling, A\u002FB test design, and PDF report generation.\n\n[![Claude Code Skill](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude%20Code-Skill-blue)](https:\u002F\u002Fclaude.ai\u002Fclaude-code)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FAgriciDaniel\u002Fclaude-ads)](https:\u002F\u002Fgithub.com\u002FAgriciDaniel\u002Fclaude-ads\u002Freleases)\n[![CI](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002FAgriciDaniel\u002Fclaude-ads\u002Fci.yml?branch=main&label=CI)](https:\u002F\u002Fgithub.com\u002FAgriciDaniel\u002Fclaude-ads\u002Factions)\n\n> **Blog:** [Read the full ad audit breakdown](https:\u002F\u002Fagricidaniel.com\u002Fblog\u002Fclaude-code-ad-agency)\n\n## Contents\n\n- [Installation](#installation)\n- [Demo](#demo)\n- [Quick Start](#quick-start)\n- [Commands](#commands)\n- [Features](#features)\n- [Architecture](#architecture)\n- [How It Analyzes Your Ads](#how-it-analyzes-your-ads)\n- [FAQ](#faq)\n- [Requirements](#requirements)\n- [Uninstall](#uninstall)\n- [Related Projects](#related-projects)\n- [License](#license)\n\n## Installation\n\n### Plugin Install (Recommended)\n\nAdd the marketplace and install in Claude Code:\n\n```shell\n\u002Fplugin marketplace add AgriciDaniel\u002Fclaude-ads\n\u002Fplugin install claude-ads@agricidaniel-claude-ads\n```\n\nThis registers claude-ads as a native plugin with auto-updates, namespace isolation, and proper version tracking.\n\n### One-Command Install (Unix\u002FmacOS\u002FLinux)\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgriciDaniel\u002Fclaude-ads\u002Fmain\u002Finstall.sh | bash\n```\n\n### One-Command Install (Windows PowerShell)\n\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002FAgriciDaniel\u002Fclaude-ads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n### Manual Install\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FAgriciDaniel\u002Fclaude-ads.git\ncd claude-ads\n.\u002Finstall.sh          # Unix\u002FmacOS\u002FLinux\n```\n\n```powershell\n.\\install.ps1         # Windows PowerShell\n```\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F20-install-methods.svg\" alt=\"Installation Methods Comparison\" width=\"100%\">\n\u003C\u002Fp>\n\n## Demo\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdemo.gif\" alt=\"Claude Ads Demo\" width=\"100%\">\n\u003C\u002Fp>\n\n## Quick Start\n\n```bash\n# Start Claude Code\nclaude\n\n# Run a full multi-platform audit\n\u002Fads audit\n\n# Deep analysis for a single platform\n\u002Fads google\n\u002Fads meta\n\u002Fads linkedin\n\n# Strategic planning by business type\n\u002Fads plan saas\n\u002Fads plan ecommerce\n\u002Fads plan local-service\n\n# Cross-platform creative audit\n\u002Fads creative\n\n# Budget and bidding strategy review\n\u002Fads budget\n```\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F06-how-it-works.svg\" alt=\"How It Works: 5-Step Process\" width=\"100%\">\n\u003C\u002Fp>\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `\u002Fads audit` | Full multi-platform audit with parallel subagent delegation |\n| `\u002Fads google` | Google Ads deep analysis (Search, PMax, Display, YouTube, Demand Gen) |\n| `\u002Fads meta` | Meta Ads deep analysis (FB, IG, Advantage+ Shopping) |\n| `\u002Fads youtube` | YouTube Ads specific analysis (Skippable, Shorts, Demand Gen) |\n| `\u002Fads linkedin` | LinkedIn Ads deep analysis (B2B, Lead Gen, TLA) |\n| `\u002Fads tiktok` | TikTok Ads deep analysis (Creative, Shop, Smart+) |\n| `\u002Fads microsoft` | Microsoft\u002FBing Ads deep analysis (Copilot, Import validation) |\n| `\u002Fads creative` | Cross-platform creative quality audit and fatigue detection |\n| `\u002Fads landing` | Landing page quality assessment for ad campaigns |\n| `\u002Fads budget` | Budget allocation and bidding strategy review |\n| `\u002Fads apple` | Apple Ads deep analysis (campaign structure, bids, CPPs, Maximize Conversions, TAP) |\n| `\u002Fads plan \u003Ctype>` | Strategic ad plan with industry templates |\n| `\u002Fads competitor` | Competitor ad intelligence across all platforms |\n| `\u002Fads math` | PPC financial calculator (CPA, ROAS, break-even, budget forecasting, LTV:CAC) |\n| `\u002Fads test` | A\u002FB test design (hypothesis framework, significance, sample size, duration) |\n| `\u002Fads report` | Generate PDF audit report for client deliverables |\n\n### `\u002Fads audit`\n**Full Multi-Platform Audit**\n\nSpawns 6 parallel subagents to analyze your ad accounts simultaneously:\n- **audit-google**: 80 checks across Search, PMax, AI Max, Demand Gen, CTV, YouTube\n- **audit-meta**: 50 checks across Pixel\u002FCAPI, Andromeda creative diversity, Structure, Audience\n- **audit-creative**: 21+ cross-platform creative quality checks with Andromeda and Symphony awareness\n- **audit-tracking**: 8+ conversion tracking and privacy infrastructure checks (Consent Mode V2, CAPI, Events API, AdAttributionKit)\n- **audit-budget**: 24 budget and bidding strategy checks\n- **audit-compliance**: 18+ compliance checks (ECPC deprecated, VAC deprecated, EU messaging, Apple rebrand)\n\nGenerates a unified **Ads Health Score (0-100)** with prioritized action plan.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F02-parallel-audit.svg\" alt=\"Parallel Audit Pipeline\" width=\"100%\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F19-audit-lifecycle.svg\" alt=\"Audit Lifecycle\" width=\"100%\">\n\u003C\u002Fp>\n\n### `\u002Fads plan \u003Cbusiness-type>`\n**Strategic Ad Planning**\n\nIndustry-specific templates with platform mix, campaign architecture, creative strategy, targeting, budget guidelines, and KPI targets.\n\n**Supported business types:**\n- `saas`: Trial\u002Fdemo focus, Google + LinkedIn primary\n- `ecommerce`: Shopping\u002FPMax, ROAS-focused, seasonal\n- `local-service`: Google Search + LSA, call tracking, geo radius\n- `b2b-enterprise`: LinkedIn ABM, long sales cycle, pipeline metrics\n- `info-products`: Meta + YouTube, webinar\u002FVSL funnels\n- `mobile-app`: Meta + Google UAC, MMP required, LTV:CPI\n- `real-estate`: Special Ad Category (housing), buyer\u002Fseller campaigns\n- `healthcare`: HIPAA compliance, LegitScript, restricted targeting\n- `finance`: Special Ad Category (credit), required disclosures\n- `agency`: Multi-client management, reporting framework\n- `generic`: Universal template with platform selection questionnaire\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F08-industry-templates.svg\" alt=\"Industry Templates\" width=\"100%\">\n\u003C\u002Fp>\n\n### `\u002Fads math` and `\u002Fads test`\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F18-ppc-calculators.svg\" alt=\"PPC Calculators\" width=\"48%\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F17-ab-testing.svg\" alt=\"A\u002FB Test Design\" width=\"48%\">\n\u003C\u002Fp>\n\n### `\u002Fads report`\n\nGenerate professional PDF audit reports for client deliverables with health score gauge, platform comparison charts, pass\u002Ffail distribution, formatted tables, and zero-overlap layout.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F16-pdf-pipeline.svg\" alt=\"PDF Report Pipeline\" width=\"100%\">\n\u003C\u002Fp>\n\n## Features\n\n### 250+ Audit Checks\nComprehensive coverage across all platforms with weighted severity scoring:\n\n| Platform | Checks | Key Areas |\n|----------|--------|-----------|\n| Google Ads | 80 | Search, PMax, AI Max, Demand Gen, CTV, YouTube |\n| Meta Ads | 50 | Pixel\u002FCAPI, Andromeda creative diversity, Structure, Audience |\n| LinkedIn Ads | 27 | B2B targeting, TLA, Lead Gen, CRM integration |\n| TikTok Ads | 28 | Creative-first, Smart+, GMV Max, Search Ads, Events API |\n| Microsoft Ads | 24 | Google import safety, Copilot, CTV, LinkedIn targeting, video |\n| Apple Ads | 35+ | Campaign structure, CPPs, Maximize Conversions, AdAttributionKit |\n| Cross-platform | 3 | Privacy infrastructure, creative diversity, refresh cadence |\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F15-platform-grid.svg\" alt=\"Platform Coverage Grid\" width=\"100%\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F04-platform-checks.svg\" alt=\"Platform Check Distribution\" width=\"100%\">\n\u003C\u002Fp>\n\n### Ads Health Score (0-100)\nWeighted scoring algorithm with severity multipliers:\n\n| Grade | Score | Action Required |\n|-------|-------|-----------------|\n| A | 90-100 | Minor optimizations only |\n| B | 75-89 | Some improvement opportunities |\n| C | 60-74 | Notable issues need attention |\n| D | 40-59 | Significant problems present |\n| F | \u003C40 | Urgent intervention required |\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F13-scoring-algorithm.svg\" alt=\"Scoring Algorithm\" width=\"100%\">\n\u003C\u002Fp>\n\n### Industry Detection\nAuto-detects business type from ad account signals (product feeds, conversion events, platform mix, targeting patterns) and loads industry-specific benchmarks and templates.\n\n### Quality Gates\nHard rules enforced during every audit:\n- Never recommend Broad Match without Smart Bidding (Google)\n- 3x Kill Rule: flag CPA >3x target for immediate pause\n- Budget sufficiency: Meta >=5x CPA\u002Fad set, TikTok >=50x CPA\u002Fad group\n- Learning phase protection: no edits during active learning\n- Compliance: auto-check Special Ad Categories (housing\u002Fcredit\u002Ffinance)\n- **Privacy infrastructure gate**: verify tracking stack (Consent Mode V2, CAPI, Events API, AdAttributionKit) before optimization recommendations\n- **Andromeda creative diversity**: flag Meta accounts with \u003C10 genuinely distinct creatives\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F05-quality-gates.svg\" alt=\"Quality Gates\" width=\"100%\">\n\u003C\u002Fp>\n\n### Creative Pipeline\n\nAI-powered creative generation with 4 specialized agents:\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F14-creative-pipeline.svg\" alt=\"Creative Pipeline\" width=\"100%\">\n\u003C\u002Fp>\n\n### Reference Data\n25 built-in reference files with 2026-current benchmarks, bidding decision trees, platform specifications, compliance requirements, conversion tracking guides, MCP integration guide, and additional platform coverage.\n\n### Data Handling & Privacy\nClaude Ads runs entirely on your local machine via Claude Code. No ad account data is sent to external servers. When using MCP servers for live API access, data flows directly between your machine and the ad platform APIs. All analysis happens locally.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F12-privacy-flow.svg\" alt=\"Privacy and Data Flow\" width=\"100%\">\n\u003C\u002Fp>\n\n## Architecture\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F01-architecture.svg\" alt=\"3-Layer Architecture\" width=\"100%\">\n\u003C\u002Fp>\n\n```\n~\u002F.claude\u002Fskills\u002Fads\u002F              # Main orchestrator\n~\u002F.claude\u002Fskills\u002Fads\u002Freferences\u002F   # 25 RAG reference files\n~\u002F.claude\u002Fskills\u002Fads-*\u002F            # 19 sub-skills (17 original + ads-math + ads-test)\n~\u002F.claude\u002Fskills\u002Fads-plan\u002Fassets\u002F  # 12 industry templates\n~\u002F.claude\u002Fagents\u002F                  # 10 agents (6 audit + 4 creative)\n```\n\n### How It Works\n\n1. **Orchestrator** (`\u002Fads`) routes commands to specialized sub-skills\n2. **Sub-skills** provide deep single-domain analysis with structured output\n3. **Agents** run in parallel during full audits for maximum speed\n4. **References** load on-demand (RAG pattern); only what's needed per analysis\n5. **Templates** provide industry-specific strategy frameworks\n\n## How It Analyzes Your Ads\n\n**Claude Ads works with data you provide**; exports, screenshots, or pasted metrics from your ad platform dashboards. It does not connect to any ad platform API automatically.\n\n**To get accurate, account-specific recommendations:**\n1. Export your account data (last 30 days recommended)\n2. Run the relevant command: `\u002Fads google`, `\u002Fads audit`, etc.\n3. Claude will ask for your industry and budget context first; provide these for relevant benchmarks\n4. Paste or share your data when prompted\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F07-data-flow.svg\" alt=\"Data Flow\" width=\"100%\">\n\u003C\u002Fp>\n\n### Live Data Integration (Optional)\n\nFor direct API access without manual exports, pair Claude Ads with MCP servers. See `ads\u002Freferences\u002Fmcp-integration.md` for setup guides:\n- **Google Ads**: [mcp-google-ads](https:\u002F\u002Fgithub.com\u002Fcohnen\u002Fmcp-google-ads): 29 GAQL tools for live API access\n- **Meta Ads**: [Adspirer MCP](https:\u002F\u002Fwww.adspirer.com) or use included `scripts\u002Ffetch_meta_ads.py`\n- **LinkedIn Ads**: [GrowthSpree MCP](https:\u002F\u002Fwww.growthspreeofficial.com) or [Adzviser MCP](https:\u002F\u002Fadzviser.com)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fdiagrams\u002F10-mcp-integration.svg\" alt=\"MCP Integration\" width=\"100%\">\n\u003C\u002Fp>\n\n## FAQ\n\n**Can Claude Ads log into my ad manager automatically?**\nNo. Claude Ads analyzes data you provide (exports, screenshots, or pasted metrics). It doesn't connect to ad platforms automatically. See the Live Data Integration section above for Google Ads API access via MCP.\n\n**Does it use real account data or generic benchmarks?**\nBenchmarks are based on industry research (WordStream, Triple Whale, etc.) covering 16,000+ campaigns. They're averages; your results will vary by industry, budget level, and account maturity. Always provide your industry and monthly spend when running audits for the most relevant comparisons.\n\n**Is ad posting or campaign creation still manual?**\nYes. Claude Ads is an audit and strategy tool. It finds issues, recommends fixes, and builds campaign plans; but creating, editing, or posting ads remains manual in your ad platform.\n\n**Why do some recommendations seem off for my account size?**\nBenchmarks and best practices differ significantly between a $500\u002Fmonth account and a $50k\u002Fmonth account. Always tell Claude your budget upfront: *\"I spend $2k\u002Fmonth on Google Ads for a local plumbing business\"* gives much better results than running `\u002Fads google` without context.\n\n**Does it support [platform] ads?**\nCurrently supported: Google, Meta (Facebook\u002FInstagram), YouTube, LinkedIn, TikTok, Microsoft\u002FBing, and Apple Ads. Additional platforms (Reddit, CTV\u002FOTT, Pinterest, Snapchat) are covered in the reference guide for strategic planning.\n\n## Requirements\n\n- Claude Code CLI\n- Python 3.10+ with Playwright (optional, for live landing page analysis)\n- reportlab (optional, for PDF report generation via `\u002Fads report`)\n\n## Uninstall\n\n### Unix\u002FmacOS\u002FLinux\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgriciDaniel\u002Fclaude-ads\u002Fmain\u002Funinstall.sh | bash\n```\n\n### Windows PowerShell\n\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002FAgriciDaniel\u002Fclaude-ads\u002Fmain\u002Funinstall.ps1 | iex\n```\n\n## Related Projects\n\n- [Claude SEO](https:\u002F\u002Fgithub.com\u002FAgriciDaniel\u002Fclaude-seo); Comprehensive SEO analysis skill for Claude Code\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\nBuilt for Claude Code by [@AgriciDaniel](https:\u002F\u002Fgithub.com\u002FAgriciDaniel)\n\n---\n\n## Author\n\nBuilt by [Agrici Daniel](https:\u002F\u002Fagricidaniel.com\u002Fabout) - AI Workflow Architect.\n\n- [Blog](https:\u002F\u002Fagricidaniel.com\u002Fblog) - Deep dives on AI marketing automation\n- [AI Marketing Hub](https:\u002F\u002Fwww.skool.com\u002Fai-marketing-hub) - Free community, 2,800+ members\n- [YouTube](https:\u002F\u002Fwww.youtube.com\u002F@AgriciDaniel) - Tutorials and demos\n- [All open-source tools](https:\u002F\u002Fgithub.com\u002FAgriciDaniel)\n","Claude Ads 是一个为 Claude Code 设计的全面付费广告审核与优化工具，支持 Google、Meta、YouTube、LinkedIn、TikTok、Microsoft 和 Apple 广告平台。该项目通过超过 250 项检查点对广告进行深度分析，并提供行业模板、并行代理处理、A\u002FB 测试设计以及财务模型预测等功能，还能够生成详细的 PDF 报告。Claude Ads 利用 AI 技术生成创意内容，适用于需要提升在线广告效果的企业或个人，特别是在电商、SaaS 产品推广及本地服务营销等场景中表现尤为突出。其开源性质和 MIT 许可证使得用户可以自由地使用、修改和分发该软件。",2,"2026-06-11 03:48:33","high_star"]