AgriciDaniel/claude-ads

Claude Ads – AI 기반 광고 계정 감사 스킬

개요 – Claude Code(및 호환 AI 에이전트 런타임)용 오픈소스 스킬(플러그인)로, 내보낸 광고 계정 데이터(CSV/JSON, 스크린샷 또는 요약)를 읽고 구조화된 감사를 생성합니다. 12개 주요 광고 플랫폼(Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, X)에서 작동하며, 계획, 크리에이티브 브리프, 모니터링 점검, 최적화 제안, 테스트 설계도 초안을 작성할 수 있습니다.

작동 방식 –

1. 설정 – 비즈니스 모델, 목표, 지출, 플랫폼 및 승인 워크플로우를 스킬에 알려줍니다(API 키는 절대 붙여넣지 않음).
2. 증거 수집 – 계정 내보내기 파일을 업로드하거나 요약을 붙여넣습니다. 스킬은 데이터를 로컬에 저장합니다(기본적으로 읽기 전용).
3. 감사 – 플랫폼별 워커 세트가 데이터를 분석하고 각각 통과, 실패, 알 수 없음(데이터 누락) 또는 해당 없음으로 표시된 결과를 반환합니다. 모든 결과에는 해당 근거가 포함됩니다.
4. 출력 – 감사를 Markdown/HTML/PDF로 렌더링하거나, 가장 중요한 차단 항목(/ads next)을 보거나, 후속 명령(/ads plan, /ads create, /ads monitor, /ads optimize --draft, /ads experiment)을 요청할 수 있습니다.

주요 명령

명령	용도
/ads setup	클라이언트, 목표, 지출, 플랫폼 목록 및 승인 가드레일 기록
`/ads audit [platform	all]`
/ads plan	채널, 예산, 경쟁사 및 측정 권장사항 생성
/ads create	새 광고를 위한 카피, 이미지, 비디오 또는 제품 사진 브리프 생성
/ads launch --draft	라이브 계정을 건드리지 않고 캠페인 변경 계획 초안 작성
/ads monitor	게재 속도, 피로도, 정책 준수 등에 대한 지속적 점검
/ads optimize --draft	근거 기반 개선 제안
/ads experiment	통제된 테스트 설계 또는 완료된 테스트 결과 읽기
/ads report	저장된 실행을 Markdown, HTML 또는 PDF로 내보내기
/ads next / /ads status	현재 감사 상태 및 최우선 차단 항목 표시

안전 및 신뢰 – 모든 어댑터는 특정 기능이 활성화되고, 정확한 객체 ID가 제공되며, 사람이 읽을 수 있는 diff가 표시되고, 소유자 승인 상한이 준수되지 않는 한 읽기 전용입니다. 저장소에는 자격 증명이 저장되지 않으며, 환경 변수 또는 비밀 관리자를 통해 제공되어야 합니다.

선택적 동반자 – Claude Ads Cockpit(별도 플러그인)은 감사 실행을 탐색하고, 이전 실행과 비교하며, 합성 데모 데이터를 볼 수 있는 로컬 UI를 제공합니다.

설치 – Claude Code의 마켓플레이스를 통해 권장:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

또는 저장소를 클론하고 bash install.sh --source=local을 실행합니다(Codex, Gemini, Cursor 등 다른 호스트도 지원하지만 Claude Code만 공식적으로 검증됨).

프로젝트 상태 – 개발 후보: control-plane/RELEASE_REQUIREMENTS.md의 모든 게이트를 통과할 때까지 릴리스 준비가 되지 않았습니다. 12개 건강 점수 프로필은 모두 현재 비활성화되어 있으므로 감사는 결과와 근거 범위만 보고합니다. Cockpit 동반자는 선택 사항이며 아직 네이티브 플러그인으로 승인되지 않았습니다.

대상 – AI에 직접 쓰기 액세스 권한을 부여하지 않고 AI 지원, 근거 기반 광고 계정 검토를 원하는 마케팅 에이전시, 컨설턴트 및 사내 팀.

라이선스 – 코드 및 문서는 MIT; 타사 API는 자체 약관을 유지합니다.

---

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것입니다.