Meta ads manager
Skill modu-ai/cowork-plugins/moai-marketing/skills/meta-ads-manager
모두의 AI (MoAI) — Claude Cowork & Claude Code 한국 실무 도메인 AI 하네스·플러그인 마켓플레이스. 사업계획서·세무·법률·HR·마케팅·커머스·BI·콘텐츠 도메인 스킬·에이전트·워크플로우. Korean B2B + office docs (HWPX/DOCX/XLSX/PPTX/PDF) + AI media (image/video/voice). AI-slop 검수 + humanize-korean 내장.
npx -y skills add modu-ai/cowork-plugins --skill meta-ads-managerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
What its author says it does
Copied from the file, not written here
페이스북·인스타그램 광고를 자연어로 직접 만들고 켜고 끄고 예산까지 조정해 드립니다. Meta 공식 광고 AI 커넥터에 브라우저 로그인 한 번으로 연결되며, 신규 광고는 항상 꺼진(PAUSED) 상태로 만들고 켜기 전에 꼭 확인을 받습니다. 다음과 같은 요청 시 사용하세요: - "메타 광고 만들어줘", "인스타 광고 캠페인 생성해줘" - "광고세트 추가해줘", "새 광고 소재 등록해줘" - "일예산 5만원으로 올려줘", "광고 예산 변경해줘" - "광고 켜줘", "광고 꺼줘", "캠페인 일시정지해줘" - "Meta 광고 운영해줘", "AI 커넥터로 광고 관리해줘" - "전환 픽셀 캠페인에 연결해줘", "광고 타겟이랑 소재 수정해줘" 실제 계정에 변경을 적용하는 라이브 운영 스킬이라, 쓰기·예산·결제 동작은 실행 전에 항상 사용자 확인을 거칩니다. [책임 경계] vs meta-ads-analyzer·pixel-audit·campaign-planner: 이 스킬=실제 광고 생성·수정·온오프(쓰기), 저 스킬=보고서 분석·픽셀 설치 검증·캠페인 기획.
SKILL.md
8.4 KB, ~2.9k tokens by cl100k_base, as published. Nobody here has run it
Meta 광고 운영 (Meta Ads AI Connectors)
Meta 공식 Meta Ads AI Connectors(한글: Meta 광고 AI 커넥터)에 연결해, 자연어로 Meta 광고를 직접 운영합니다. Ads MCP 서버와 Ads CLI로 구성되며 2026-04-29 오픈 베타로 공개되었습니다.
책임 한 줄: 이 스킬은 Meta 광고의 라이브 운영(생성·수정·예산·온오프) 만 담당합니다. 보고서 분석·진단·설치검증·기획은 형제 스킬이 맡습니다(아래 "형제 스킬 페어 분리" 참고).
1. 연결 / 셋업
1-1. OAuth 2.0 커넥터 흐름 (1차 · 권장)
공식 기본 인증 경로입니다. 앱 생성·앱 심사·토큰 수동 복사가 필요 없습니다. 클라이언트(Claude)가 Meta Business OAuth 로그인을 브라우저에서 수행하고 액세스 토큰을 자동 발급합니다.
- 엔드포인트:
https://mcp.facebook.com/ads - 표준: RFC 9728 Protected Resource Metadata + RFC 6750 Bearer
- OAuth scope:
ads_management ads_read catalog_management business_management pages_show_list
A. Claude Cowork / Desktop (비개발자 1차 경로)
- Settings → Connectors → Add custom connector
- 이름 입력 + URL
https://mcp.facebook.com/ads입력 - 브라우저가 열리며 Meta Business OAuth 로그인 진행
- 광고 계정 / 페이지 선택 + 권한 등급 선택
- 자연어 프롬프트로 연결 확인 (예: "내 광고 계정 목록 보여줘")
B. Claude Code (.mcp.json)
정적 Authorization 헤더를 넣지 않습니다. OAuth 커넥터 흐름이 인증을 처리합니다.
{
"mcpServers": {
"meta-ads": {
"type": "http",
"url": "https://mcp.facebook.com/ads"
}
}
}
1-2. 정적 토큰 (Fallback · 강등됨)
OAuth가 불가한 개발 환경의 fallback 전용 경로입니다. 개발자/시스템 유저 토큰을 Graph API Explorer에서 발급해 META_ACCESS_TOKEN Bearer로 주입합니다. OAuth 보호 엔드포인트에는 일반 정적 Bearer가 403을 반환할 수 있으므로 항상 OAuth를 먼저 시도하고, 이 경로는 우선순위가 낮습니다.
- 토큰을 코드·SKILL.md에 하드코딩 금지
- 환경변수는
${META_ACCESS_TOKEN}구문으로만 주입
2. 권한 등급
OAuth 로그인 중 사용자가 등급을 선택합니다. 쓰기·결제 동작은 실행할 때마다 사용자 승인이 필요합니다.
| 등급 | 범위 | 권장 |
|---|---|---|
| read-only | 조회·성과 분석만 | 시작 등급(권장) |
| read+write | 캠페인·광고세트·광고 생성/수정, 예산 조정 | 운영 시 |
| financial | 결제·청구 관련 동작 | 필요 시에만 |
권한 회수: Meta Business Suite에서 커넥터 접근을 철회합니다.
3. 워크플로우
- 연결 확인 — read-only로 시작해 광고 계정·페이지 목록을 조회하고 대상을 확정한다.
- 운영 의도 수집 — 목표(전환/트래픽/도달), 대상 광고 계정, 예산, 기간, 소재를 자연어로 받는다.
- 생성/수정 제안 — 캠페인 → 광고세트 → 광고 구조로 변경안을 표로 제시한다. 신규 리소스는 PAUSED 상태로 만든다.
- 사용자 승인 — 쓰기·예산·결제 동작은 실행 전 사용자에게 확인받는다(아래 안전 가드).
- 실행 — 승인된 동작만 MCP로 실행하고 결과 ID·상태를 회신한다.
- 검증/체이닝 — 필요 시 한국 시장 audit 또는 분석 스킬로 넘긴다(§7).
운영 가능 동작
- 캠페인 / 광고세트 / 광고 생성·관리·수정 (자연어)
- 예산 설정·조정 (일예산/총예산)
- 광고 소재(크리에이티브) 등록·교체
- 전환 픽셀 연결
- 성과 분석: spend / impressions / CTR / ROAS + breakdown
4. 안전 가드 (HARD)
| 가드 | 규칙 |
|---|---|
| 기본 PAUSED | 자연어로 생성한 신규 캠페인·광고세트·광고는 항상 PAUSED로 만든다. 자동 활성화 금지. |
| 활성화 승인 | 광고를 켜거나 지출을 시작하기 전 사용자 명시 확인을 받는다. |
| 쓰기 승인 | 모든 쓰기·예산·financial 동작은 실행 전 사용자 확인을 거친다(MCP도 동작별 승인 요구). |
| 토큰 비노출 | 토큰을 코드·SKILL.md·로그에 절대 출력·저장하지 않는다. |
승인 없는 자동 활성화·예산 증액·결제는 어떤 경우에도 수행하지 않습니다.
5. 트리거 키워드
라이브 운영 동사 중심입니다(분석·진단·검증·기획은 제외).
- 생성: "메타 광고 만들어줘", "캠페인 생성", "광고세트 추가", "새 광고 등록"
- 수정: "광고 타겟 수정", "소재 교체", "광고세트 변경"
- 예산: "예산 변경", "일예산 올려/내려"
- 온오프: "광고 켜줘", "광고 꺼줘", "일시정지", "캠페인 활성화/중지"
- 운영 일반: "Meta 광고 운영", "AI 커넥터로 광고 관리", "전환 픽셀 연결"
6. 입력 / 출력
입력
- 목표(전환/트래픽/도달/참여), 대상 광고 계정·페이지
- 예산(일/총), 기간, 타겟 조건, 소재(이미지·영상·문구)
- 권한 등급(read-only / read+write / financial)
출력
- 변경안 표(캠페인→광고세트→광고, 예산, 상태=PAUSED)
- 실행 결과: 생성된 리소스 ID·상태, 적용된 변경 요약
- 성과 조회 시: spend/impressions/CTR/ROAS + breakdown 표
7. 체이닝
- 마지막 단계에서 한국 시장 audit이 필요하면
moai-ads-auditMCP(자체 50-check) 또는moai-marketing:meta-ads-analyzer스킬로 체이닝. - 운영 결과를 진단 텍스트 산출물로 정리하면
moai-core:ai-slop-reviewer→moai-content:humanize-korean체이닝으로 AI 패턴 검수 + 한국어 AI 티 제거. (수치·대시보드 산출물은 대상 아님)
권장 체인 예:
meta-ads-manager (생성·운영)
→ moai-marketing:meta-ads-analyzer / moai-ads-audit MCP (진단)
→ moai-core:ai-slop-reviewer (진단 텍스트 검수)
→ moai-content:humanize-korean (한국어 AI 티 제거)
8. 형제 스킬 페어 분리
| 스킬 | 담당(책임) | 동사 성격 | 겹치지 않게 |
|---|---|---|---|
| meta-ads-manager (본 스킬) | Meta 광고 라이브 운영 (공식 MCP) | 생성·수정·예산·온오프 | 운영 동사만 |
| meta-ads-analyzer | Meta 광고 보고서 분석·진단 (read/report) | 분석·해석·리포트 | "분석/진단/리포트" 요청은 analyzer로 |
| pixel-audit | 픽셀·CAPI 설치 검증 | 점검·검증 | "픽셀 설치 확인"은 pixel-audit로 |
| campaign-planner | 캠페인 기획(인지편향) | 기획·설계 | "캠페인 기획/전략"은 planner로 |
판단 기준: "실제로 만들거나 바꾸거나 켜고 끄는가?"(=manager) vs "읽고 해석·검증·기획하는가?"(=형제 스킬).