GitHub - AgriciDaniel/claude-ads: 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.
핵심 포인트
- 1Claude Ads는 Google Ads, Meta Ads 등 주요 유료 광고 플랫폼에 대한 종합적인 감사 및 최적화 기능을 제공하는 Claude Code 스킬입니다.
- 2이 도구는 250개 이상의 감사 체크, 산업별 템플릿, 병렬 서브 에이전트, PPC financial modeling, A/B test design 등을 통해 광고 계정의 문제를 진단하고 해결책을 제시합니다.
- 3사용자 제공 데이터(exports, screenshots)를 기반으로 로컬에서 실행되며, Ads Health Score를 포함한 포괄적인 PDF audit report를 생성하여 광고 전략 수립을 돕습니다.
Claude Ads는 Claude Code를 위한 포괄적인 유료 광고 감사(audit) 및 최적화(optimization) 스킬입니다. 이는 Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, Apple Ads를 포함한 주요 플랫폼을 지원하며, 250개 이상의 감사 항목(audit checks), 산업별 템플릿(industry-specific templates), 병렬 서브에이전트 위임(parallel subagent delegation), PPC 재무 모델링(financial modeling), A/B 테스트 설계(test design), PDF 보고서 생성(report generation) 기능을 제공합니다.
주요 기능 및 지원 플랫폼:
이 도구는 다양한 광고 플랫폼에 대한 심층적인 분석을 제공합니다:
- Google Ads: Search, PMax, AI Max, Demand Gen, CTV, YouTube를 포함하여 80가지 항목을 검사합니다.
- Meta Ads: Pixel/CAPI, Andromeda creative diversity, 캠페인 구조(structure), 잠재고객(audience)에 대한 50가지 항목을 검사합니다.
- LinkedIn Ads: B2B 타겟팅, TLA, 리드 생성(Lead Gen), CRM 통합에 대한 27가지 항목을 검사합니다.
- TikTok Ads: Creative-first, Smart+, GMV Max, Search Ads, Events API에 대한 28가지 항목을 검사합니다.
- Microsoft Ads: Google import safety, Copilot, CTV, LinkedIn targeting, video에 대한 24가지 항목을 검사합니다.
- Apple Ads: 캠페인 구조, CPPs, Maximize Conversions, AdAttributionKit에 대한 35가지 이상의 항목을 검사합니다.
- 이 외에도 크로스 플랫폼 크리에이티브 품질 감사(/ads creative), 랜딩 페이지 품질 평가(/ads landing), 예산 할당 및 입찰 전략 검토(/ads budget) 기능을 제공합니다.
Ads Health Score (0-100):
가중치 기반 점수 알고리즘과 심각도 승수(severity multipliers)를 사용하여 광고 계정의 전반적인 상태를 평가하는 점수입니다. 점수 범위는 다음과 같습니다:
- A (90-100): 사소한 최적화만 필요.
- B (75-89): 개선 기회가 일부 존재.
- C (60-74): 주목할 만한 문제점 존재, 주의 필요.
- D (40-59): 심각한 문제점 존재.
- F (<40): 긴급한 개입 필요.
Quality Gates (품질 검증 게이트):
각 감사(audit) 중에 강제되는 규칙들입니다. 예를 들어, Smart Bidding 없이 Broad Match를 권장하지 않거나, CPA가 목표의 3배를 초과하면 즉시 캠페인 일시 중지를 권고하고, Meta Ads의 경우 광고 세트당 CPA의 5배, TikTok Ads의 경우 광고 그룹당 CPA의 50배 이상의 예산 적정성을 확인합니다. 또한 학습 단계(learning phase) 중에는 수정을 하지 않도록 보호하고, 특별 광고 카테고리(housing/credit/finance)에 대한 규정 준수 여부를 자동 확인하며, Consent Mode V2, CAPI, Events API, AdAttributionKit과 같은 추적 인프라(tracking infrastructure)를 검증합니다. Andromeda creative diversity는 Meta 계정에서 10개 미만의 고유한 크리에이티브가 감지될 경우 플래그를 지정합니다.
산업 감지(Industry Detection):
광고 계정 신호(제품 피드, 전환 이벤트, 플랫폼 믹스, 타겟팅 패턴)를 통해 사업 유형을 자동 감지하고, 해당 산업에 특화된 벤치마크 및 템플릿을 로드합니다. /ads plan 명령어를 통해 SaaS, 이커머스(ecommerce), 로컬 서비스(local-service), B2B 엔터프라이즈(b2b-enterprise), 정보 상품(info-products), 모바일 앱(mobile-app), 부동산(real-estate), 헬스케어(healthcare), 금융(finance), 에이전시(agency), 일반(generic) 등 다양한 산업별 전략 템플릿을 제공합니다.
명령어 (Commands):
/ads audit: 병렬 서브에이전트 위임(parallel subagent delegation)을 통해 전체 다중 플랫폼 감사를 수행합니다./ads google,/ads meta등: 특정 플랫폼에 대한 심층 분석을 수행합니다./ads creative: 크로스 플랫폼 크리에이티브 품질 감사 및 피로도 감지(fatigue detection)를 수행합니다./ads math: CPA, ROAS, 손익분기점(break-even), 예산 예측, LTV:CAC와 같은 PPC 재무 계산을 제공합니다./ads test: 가설 프레임워크, 유의미성(significance), 표본 크기(sample size), 기간(duration) 등을 포함한 A/B 테스트 설계를 지원합니다./ads report: 클라이언트 제공물(client deliverables)을 위한 전문적인 PDF 감사 보고서를 생성합니다.
핵심 방법론 및 아키텍처:
Claude Ads는 Claude Code를 통해 사용자의 로컬 머신에서 전적으로 실행됩니다. 광고 계정 데이터는 외부 서버로 전송되지 않습니다. MCP servers를 사용하여 live API access를 하는 경우에도 데이터는 사용자 기기와 광고 플랫폼 API 간에 직접 흐르며, 모든 분석은 로컬에서 이루어집니다.
- Orchestrator (
/ads): 최상위Orchestrator는 들어오는 명령을 전문화된sub-skills로 라우팅합니다. - Sub-skills: 각
sub-skill은 특정 도메인에 대한 심층적인 분석을 수행하며 구조화된 출력을 제공합니다 (예:/ads google,/ads meta). - Agents: 전체 감사(
/ads audit) 중에는 6개의 병렬subagents(audit-google, audit-meta, audit-creative, audit-tracking, audit-budget, audit-compliance)가 동시에 실행되어 최대 속도를 보장합니다. - References (RAG 패턴): 25개의 내장된 참조 파일(reference files)은 2026년 최신 벤치마크, 입찰 의사결정 트리, 플랫폼 사양, 규정 준수 요구 사항, 전환 추적 가이드 등을 포함하며, 필요할 때만 로드되는 RAG (Retrieval Augmented Generation) 패턴을 사용합니다.
- Templates: 12개의 산업별 템플릿(industry templates)은 플랫폼 믹스, 캠페인 아키텍처, 크리에이티브 전략, 타겟팅, 예산 가이드라인, KPI 목표를 포함한 산업별 전략 프레임워크를 제공합니다.
데이터 분석 방식:
Claude Ads는 사용자가 제공하는 데이터(내보내기 파일, 스크린샷, 또는 붙여넣기된 지표)를 통해 작동합니다. 자동으로 광고 플랫폼 API에 연결되지 않습니다. 정확하고 계정 특유의 권장 사항을 얻기 위해 사용자는 계정 데이터를 내보내고(지난 30일 권장), 관련 명령어를 실행하며, Claude가 산업 및 예산 컨텍스트를 요청할 때 이를 제공해야 합니다. MCP servers를 통한 Live Data Integration은 선택적으로 제공됩니다.
제한 사항 및 FAQ:
- 자동으로 광고 관리자에 로그인할 수 없으며, 사용자가 데이터를 제공해야 합니다.
- 광고 게재(ad posting) 또는 캠페인 생성(campaign creation)은 수동으로 이루어져야 합니다. Claude Ads는 감사 및 전략 도구입니다.
- 권장 사항은 계정 규모에 따라 달라질 수 있으므로, 감사를 실행할 때 항상 예산 컨텍스트를 제공하는 것이 중요합니다.
요구 사항:
Claude Code CLI, Python 3.10+ (Playwright 및 reportlab은 선택 사항).