使用说明
克劳德代码的元广告分析器
克劳德代码技能+MCP服务器设置，用于专家级元广告活动分析。包括 故障效应 框架、学习阶段诊断和Meta官方文档中的9个参考文档。
它的作用
安装后，Claude Code可以：
- 分析活动、广告集和广告级别性能数据
- 使用Meta的系统机制确定性能问题的根本原因
- 解释一下 故障效应 （为什么Meta将预算分配给看似“更差”的细分市场）
- 诊断学习阶段、拍卖重叠、起搏和创造性疲劳问题
- 生成具有可操作建议的结构化分析报告
- 直接连接Meta的API以获取实时活动数据（通过MCP）
组件
| 组件 | 它的作用 |
|---|---|
技能 (skill/) |
Claude作为上下文加载的包含9个参考文档的分析框架 |
MCP服务器 (mcp/) |
将Claude Code连接到Meta的营销API以获取实时数据 |
脚本 (scripts/) |
设置和令牌刷新帮助程序 |
先决条件
安装
1.安装技能
复制 skill/ 将文件夹放入您的Claude Code项目中：
# From your Claude Code project root
mkdir -p .claude/skills/meta-ads-analyzer
cp -r skill/* .claude/skills/meta-ads-analyzer/
该技能现在处于活动状态。当您询问Meta Ads分析时，Claude会自动使用它。
2.设置MCP服务器（可选，用于实时数据）
MCP服务器允许Claude从Meta的API获取实时活动数据。如果您只想分析导出的数据（CSV、屏幕截图），请跳过此步骤。
a） 创建元应用程序
- 首选 developers.facebook.com
- 创建新应用程序（类型： 商业)
- 添加 API营销 产品
- 注意你的 应用程序ID 和 应用密钥
b） 生成访问令牌
- 首选 图形API资源管理器
- 选择您的应用程序
- 添加权限：
ads_read,ads_management,business_management - 点击 生成访问令牌 并授权
- 使用安装脚本交换长期令牌（60天）：
bash scripts/setup.sh
c） 配置Claude代码
复制MCP配置模板并添加您的凭据：
cp mcp/mcp.json.example .mcp.json
编辑 .mcp.json 并将占位符替换为您的实际令牌和应用程序密钥。
然后重新启动Claude Code以连接MCP服务器。
3.验证
问克劳德： “分析我的元广告活动” --它应该连接到您的广告帐户并开始分析。
令牌刷新
元长期令牌在约60天后过期。要刷新：
bash scripts/refresh_token.sh
如果令牌已过期，请从 图形API资源管理器 然后跑 scripts/setup.sh 再一次。
用法示例
安装后，您可以向Claude询问以下问题：
- “分析我过去7天的活动”
- “为什么我的注册会计师在这场运动中越来越多？”
- “比较不同职位的表现”
- “诊断此广告集在Learning Limited中的原因”
- “导出[活动名称]的完整分析报告”
您还可以从Meta Ads Manager粘贴CSV导出或屏幕截图——该技能适用于任何数据格式。
参考文件中有什么
| 文档 | 封面 |
|---|---|
breakdown_effect.md |
为什么Meta将预算分配给“昂贵”的细分市场 |
core_concepts.md |
广告拍卖、起搏、学习阶段概述 |
learning_phase.md |
学习如何运作，何时重置 |
ad_relevance_diagnostics.md |
质量、参与度、转化率排名 |
auction_overlap.md |
当你的广告相互竞争时 |
pacing.md |
预算和投标节奏机制 |
bid_strategies.md |
基于支出、基于目标、手动竞价 |
ad_auctions.md |
如何确定拍卖获胜者 |
performance_fluctuations.md |
正常与令人担忧的性能变化 |
许可证
麻省理工学院
