mcpbeat

Meta Ads Manager

modu-ai/meta-ads-manager

| 페이스북·인스타그램 광고를 자연어로 직접 만들고 켜고 끄고 예산까지 조정해 드립니다. Meta 공식 광고 AI 커넥터에 브라우저 로그인 한 번으로 연결되며, 신규 광고는 항상 꺼진(PAUSED) 상태로 만들고 켜기 전에 꼭 확인을 받습니다. 실제 계정에 변경을 적용하는 라이브 운영 스킬이라, 쓰기·예산·결제 동작은 실행 전에 항상 사용자 확인을 거칩니다.

2k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
265
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/modu-ai/cowork-plugins --skill meta-ads-manager

The instruction itself

14 sections, as written by the author

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-audit MCP(자체 50-check) 또는 moai-marketing:meta-ads-analyzer 스킬로 체이닝.
  • 운영 결과를 진단 텍스트 산출물로 정리하면 moai-core:ai-slop-reviewermoai-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 "읽고 해석·검증·기획하는가?"(=형제 스킬).


9. 출처

How to use it

Copy the folder

Take modu-ai/meta-ads-manager from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.