AgriciDaniel/claude-ads

Claude Ads: Claude Code용 유료 광고 감사 스킬

단일 Google Ads 계정을 수동으로 감사하는 데는 숙련된 PPC 전문가가 4-6시간이 소요됩니다. Claude Ads는 동일한 감사를 10-15분 안에 수행하고, 0-100 가중치 점수로 평가하며, Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon Ads 전반에 걸쳐 우선순위가 지정된 실행 계획을 출력합니다. PPC 에이전시, 사내 마케터, 프리랜서 광고 컨설턴트를 위해 제작되었습니다. 로컬, 결정론적, MIT 라이선스.

호스트 지원:

마지막 업데이트: 2026-05-18 · 버전: v1.7.1 · CHANGELOG · 블로그: 전체 광고 감사 분석

이 스킬의 두 가지 버전.

- 🌐 공개 오픈소스 → AgriciDaniel/claude-ads: MIT, 공개 릴리스, 멤버십 불필요. 안정적이고 다운로드 가능한 버전을 원하는 경우에 가장 적합합니다.

- 🔒 커뮤니티 비공개 미러 → AI-Marketing-Hub/claude-ads: 향후 기능에 대한 조기 액세스 및 AI Marketing Hub Pro 커뮤니티와의 직접 협업. 멤버십 필요.

대상 사용자

• 5개 이상의 계정을 운영하는 PPC 에이전시: 분기별이 아닌 매주 모든 계정을 감사합니다. 동일한 시간 예산.
• 4개 이상의 플랫폼에서 유료 광고를 담당하는 사내 마케터: 임원 검토 전에 두 번째 검토자 역할. 선호하는 플랫폼에 대한 인간의 편향 없음.
• 프리랜서 PPC 컨설턴트: 10분 감사로 첫날 클라이언트 범위를 설정합니다. 진단에 한 시간을 소비하기 전에 업무를 수주하세요.

v1.7.0(Wave 2)의 새로운 기능

• 3개의 새로운 하위 스킬: /ads amazon (Sponsored Products/Brands/Display, ACOS/TACOS), /ads attribution (AdAttributionKit + GA4 + Consent Mode V2), /ads tracking (sGTM + CAPI Gateway + 중복 제거 + 해싱).
• tests/ 디렉토리의 41개 테스트 pytest 평가 도구: 라우팅 스냅샷, 양방향 209개 검사 카탈로그 적용 범위, 점수 수학 결정론, SSRF 회귀 테스트. 모든 커밋에서 CI로 실행됩니다.
• 교차 런타임 설치 매트릭스: install.sh / install.ps1 --target= (Claude Code, Codex CLI, Cursor, Windsurf, Gemini CLI, Goose에 대한 허용 목록 검증 포함).
• 심층 플랫폼 재작성: /ads google (AI Max 시대: aimaxsetting.enableaimax, AI Brief, FUE, 브랜드 제외). /ads meta (Andromeda + GEM + Lattice 시대, Entity-ID 클러스터링 감지 포함).
• 10가지 원칙 사고 프레임워크: 모든 감사, 계획 및 크리에이티브 출력은 공유 인지 규율 하에 실행됩니다. ads/references/thinking-framework.md 참조.

전체 릴리스 노트: CHANGELOG.md.

데모

샘플 출력

/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 크리에이티브 유사성 > 60%: 검색 억제 위험",
      "impact": "예상 도달 손실 20-35%; 4개 광고 세트 영향",
      "action": "7개의 거의 중복된 크리에이티브를 개념적으로 다양한 변형으로 교체",
      "owner": "creative",
      "eta_days": 7
    },
    {
      "id": "G-AIM-03",
      "severity": "high",
      "platform": "google",
      "title": "부정 키워드 규율 없이 AI Max 활성화됨",
      "impact": "관련 없는 검색어에 월 ~$1,400 낭비",
      "action": "30일 검색어 보고서에서 부정 키워드 목록 작성",
      "owner": "search",
      "eta_days": 2
    }
  ],
  "quick_wins": [
    "Consent Mode V2 활성화(Privacy Sandbox 호환, 약 1시간 소요)",
    "3x Kill Rule을 위반하는 3개 광고 그룹 일시 중지(월 ~$420 절약)"
  ]
}

추가로 PDF 버전(/ads report)은 건강 점수 게이지, 플랫폼 비교 차트 및 클라이언트 전달을 위한 제로 오버랩 레이아웃을 제공합니다.

목차

• 설치: Claude Ads를 추가하는 3가지 방법
• 빠른 시작
• 명령어
• 기능: 250개 이상의 감사 검사가 다루는 내용
• 수동/에이전시/상용 도구와의 비교
• 사용 사례
• 평가 도구: 검증된 엄격함
• 아키텍처
• 광고 분석 방법
• FAQ
• 요구 사항
• 제거
• 로드맵
• 프로젝트 정보
• 관련 프로젝트
• 관리자
• 라이선스

설치: Claude Ads를 추가하는 3가지 방법

ℹ️ 두 가지 설치 경로 — 액세스 권한에 맞는 것을 선택하세요.

>

아래 명령어는 기본적으로 AI-Marketing-Hub/claude-ads의 커뮤니티 비공개 미러(Pro 회원을 위한 조기 액세스)를 사용합니다. 공개 릴리스 AgriciDaniel/claude-ads(MIT, 멤버십 불필요)를 사용하려면 모든 명령어에서 AI-Marketing-Hub/claude-ads를 AgriciDaniel/claude-ads로, 플러그인 슬러그 claude-ads@ai-marketing-hub-claude-ads를 claude-ads@agricidaniel-claude-ads로 바꾸세요.

>

Pro 회원: AI-Marketing-Hub 조직에 액세스할 수 있는 gh auth login(또는 PAT)이 필요합니다. /plugin marketplace add가 404를 반환하면 Skool 커뮤니티에서 DM을 보내 추가해 달라고 요청하세요.

1. 플러그인 설치(Claude Code, 권장)

/plugin marketplace add AI-Marketing-Hub/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

claude-ads를 네이티브 플러그인으로 등록하여 자동 업데이트, 네임스페이스 격리 및 버전 추적을 제공합니다.

2. 원클릭 설치(Unix/macOS/Linux)

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

2. 원클릭 설치(Windows PowerShell)

irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-ads/main/install.ps1 | iex

3. 교차 호스트 설치(Codex CLI / Cursor / Windsurf / Gemini CLI / Goose)

# Unix/macOS/Linux
bash install.sh --target=codex      # OpenAI Codex CLI       (실험적)
bash install.sh --target=cursor     # Cursor IDE              (실험적)
bash install.sh --target=windsurf   # Windsurf IDE            (실험적)
bash install.sh --target=gemini     # Gemini CLI              (실험적)
bash install.sh --target=goose      # Goose CLI               (실험적)

# Windows PowerShell.\install.ps1 -Target codex.\install.ps1 -Target cursor.\install.ps1 -Target windsurf.\install.ps1 -Target gemini.\install.ps1 -Target goose

호스트별 설치 경로 표:

경로 재정의:

bash install.sh --target=claude --skill-dir=~/custom/skills --agent-dir=~/custom/agents

대상 및 재정의 경로는 엄격하게 허용 목록 검증됩니다: 셸 인젝션, 플래그 혼동, .. 세그먼트, UNC 경로 없음.

⚠ 실험적 대상: Claude Code만 종단 간 검증되었습니다. 다른 호스트 설치 경로는 각 호스트의 문서화된 규칙을 따릅니다. 스킬 검색 및 하위 스킬 라우팅이 다를 수 있습니다. 대상 조정이 필요한 경우 재현 세부 정보와 함께 이슈를 열어주세요.

수동 설치

git clone https://github.com/AI-Marketing-Hub/claude-ads.git
cd claude-ads./install.sh                # Unix/macOS/Linux, 기본 target=claude./install.sh --target=codex # 모든 교차 호스트 대상

빠른 시작

# Claude Code 시작
claude

# 전체 멀티 플랫폼 감사 실행
/ads audit

# 단일 플랫폼 심층 분석
/ads google
/ads meta
/ads linkedin

# 비즈니스 유형별 전략 계획
/ads plan saas
/ads plan ecommerce
/ads plan local-service

# 교차 플랫폼 크리에이티브 감사
/ads creative

# 예산 및 입찰 전략 검토
/ads budget

명령어

/ads audit

전체 멀티 플랫폼 감사

• audit-google: Search, PMax, AI Max, Demand Gen, CTV, YouTube 전반의 80개 검사
• audit-meta: Pixel/CAPI, Andromeda 크리에이티브 다양성, 구조, 잠재고객 전반의 50개 검사
• audit-creative: Andromeda Entity-ID 및 Symphony 인식을 통한 교차 플랫폼 크리에이티브 품질
• audit-tracking: 전환 추적 + 개인정보 보호 인프라(Consent Mode V2, CAPI, Events API, AdAttributionKit)
• audit-budget: LinkedIn, TikTok, Microsoft 전반의 예산 및 입찰
• audit-compliance: 모든 플랫폼의 규정 준수, 설정, 성능 벤치마크

6개의 병렬 하위 에이전트를 생성합니다:

우선순위가 지정된 실행 계획과 함께 통합 Ads Health Score(0-100)를 생성합니다.

Wave 2 독립형 하위 스킬. /ads audit는 위의 6개 에이전트를 병렬로 위임합니다. Amazon, 기여도, 서버사이드 추적은 독립형 하위 스킬(/ads amazon, /ads attribution, /ads tracking)입니다. 직접 호출하세요. Wave 3에서는 해당 페어링된 감사 에이전트가 추가됩니다.

/ads plan

전략적 광고 계획

플랫폼 조합, 캠페인 아키텍처, 크리에이티브 전략, 타겟팅, 예산 가이드라인 및 KPI 목표가 포함된 업계 템플릿.

• saas: 평가판/데모 중심, Google + LinkedIn 기본
• ecommerce: 쇼핑/PMax, ROAS 중심, 계절별
• local-service: Google Search + LSA, 통화 추적, 지리적 반경
• b2b-enterprise: LinkedIn ABM, 긴 판매 주기, 파이프라인 지표
• info-products: Meta + YouTube, 웨비나/VSL 퍼널
• mobile-app: 앱 설치 캠페인, 인앱 이벤트 최적화

지원되는 비즈니스 유형:

[...생략됨...]