전문가급 메타 광고 캠페인 분석을 위한 Claude 코드 스킬 + MCP 서버 설정. Breakdown Effect 프레임워크, 학습 단계 진단, 그리고 Meta 공식 문서에서 9개의 참고 문서를 포함합니다.

그것이 하는 일들

설치 시 Claude Code는 다음과 같은 기능을 수행할 수 있습니다:

• 캠페인, 광고 세트, 광고 수준 성과 데이터 분석
• Meta의 시스템 메커니즘을 사용하여 성능 문제의 근본 원인을 식별하기
• 붕괴 효과 설명 (메타가 겉보기에는 ‘더 나쁜’ 세그먼트에 예산을 배분하는 이유)
• 학습 단계, 경매 중복, 진행 속도 및 창의적 피로 문제 진단
• 실행 가능한 권고안이 포함된 구조화된 분석 보고서 생성
• 메타의 API에 직접 연결하여 실시간 캠페인 데이터를 가져올 수 있습니다 (MCP 통해)

구성 요소

선수 조건

• 클로드 코드 설치
• Node.js v18+
• 마케팅 API 접근 권한이 있는 메타 앱 (여기에서 생성 가능)

설치

1. 스킬 설치

Meta Ads Analyzer for Claude Code

A Claude Code skill + MCP server setup for expert-level Meta Ads campaign analysis. Includes the Breakdown Effect framework, Learning Phase diagnostics, and 9 reference documents from Meta’s official documentation.

What It Does

When installed, Claude Code can:

• Analyze campaign, ad set, and ad-level performance data
• Identify root causes of performance issues using Meta’s system mechanics
• Explain the Breakdown Effect (why Meta allocates budget to seemingly “worse” segments)
• Diagnose Learning Phase, Auction Overlap, Pacing, and Creative Fatigue issues
• Generate structured analysis reports with actionable recommendations
• Connect directly to Meta’s API to pull live campaign data (via MCP)

Components

Prerequisites

• Claude Code installed
• Node.js v18+
• A Meta App with Marketing API access (create one here)

Installation

1. Install the Skill

Copy the skill/ folder into your Claude Code project:

# From your Claude Code project root
mkdir -p .claude/skills/meta-ads-analyzer
cp -r skill/* .claude/skills/meta-ads-analyzer/

The skill is now active. Claude will automatically use it when you ask about Meta Ads analysis.

2. Set Up the MCP Server (optional, for live data)

The MCP server lets Claude pull live campaign data from Meta’s API. Skip this if you only want to analyze exported data (CSV, screenshots).

a) Create a Meta App

1. Go to developers.facebook.com
2. Create a new app (type: Business)
3. Add the Marketing API product
4. Note your App ID and App Secret

b) Generate an Access Token

1. Go to Graph API Explorer
2. Select your app
3. Add permissions: ads_read, ads_management, business_management
4. Click Generate Access Token and authorize
5. Exchange for a long-lived token (60 days) using the setup script:

bash scripts/setup.sh

c) Configure Claude Code

Copy the MCP config template and add your credentials:

cp mcp/mcp.json.example .mcp.json

Edit .mcp.json and replace the placeholders with your actual token and app secret.

Then restart Claude Code for the MCP server to connect.

3. Verify

Ask Claude: “Analyze my Meta Ads campaigns” — it should connect to your ad account and start analyzing.

Token Refresh

Meta long-lived tokens expire after ~60 days. To refresh:

bash scripts/refresh_token.sh