This project provides a Claude Code skill and MCP server for expert Meta Ads campaign analysis. It diagnoses key performance issues like the Breakdown Effect, Learning Phase, Auction Overlap, and Creative Fatigue, delivering structured reports with actionable recommendations. Aimed at Claude Code users, it benefits from advanced analysis frameworks and optional live API data integration.

How It Works

A Claude Code "Skill" integrates analysis frameworks and 9 official Meta Ads reference documents, enabling nuanced interpretation of campaign data and diagnosis of mechanics like the Breakdown Effect and Learning Phase. An optional Node.js MCP server connects Claude Code to Meta's Marketing API for live data fetching. Helper scripts manage setup and token refresh, combining AI interpretation with direct data access.

Quick Start & Requirements

• Prerequisites: Claude Code, Node.js v18+, Meta App with Marketing API access (App ID, App Secret).
• Installation:
  1. Skill: Copy skill/ to .claude/skills/meta-ads-analyzer.
  2. MCP Server (Optional): Create Meta App, grant ads_read, ads_management, business_management permissions, generate long-lived token via Graph API Explorer, run scripts/setup.sh, configure .mcp.json, restart Claude Code.
• Token Refresh: Use scripts/refresh_token.sh or re-run scripts/setup.sh.
• Links: Meta App creation: developers.facebook.com

Highlighted Details

• Expert Meta Ads campaign analysis framework for Claude Code.
• Diagnoses Breakdown Effect, Learning Phase, Auction Overlap, Pacing, and Creative Fatigue.
• Includes 9 official Meta Ads reference documents.
• Optional MCP server enables live data analysis via Meta's Marketing API.
• Supports static data formats (CSV, screenshots).

Maintenance & Community

No specific details regarding maintainers, community channels, or project roadmap are provided in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive MIT license allows commercial use and integration into closed-source projects.

Limitations & Caveats

Fundamentally dependent on the Claude Code environment. Live data analysis requires significant setup (Meta developer accounts, API permissions). Meta API access tokens expire (~60 days) and necessitate periodic refreshing, adding an ongoing maintenance task.