KonQuest元广告MCP
Claude Code的监管元广告操作系统。 您可以在此处找到高级版本：https://farasokster.gumroad.com/l/konquest-meta-ads-mcp-premium
开放核心模型
KonQuest Meta Ads MCP使用开放核心模型：
公共（此仓库）-57个工具，MIT许可证：
- 活动、广告集和广告的完整CRUD
- 多资产广告创作（视频+静态图像，多维）
- 图像上传和检索
- 活动和广告集复制
- 洞察和批量跨账户分析
- 像素和跟踪诊断（5个工具）
- 目录和DPA支持（6个工具，包括产品集创建/更新）
- 完整的目标工具包（6个工具）
- 设置就绪检查器（42次以上检查，并附有修复说明）
- 验证管道、命名强制、写后验证
- 安全级别、速率限制、回滚引用
- 215项自动化测试
高级捆绑包-增加了41个工具：
- 咨询优化引擎（审查队列、学习、实验、预算调节器、创意轮换）
- 保险库智能和副本生成（品牌声音、ICP定位、概念选择）
- 希腊语QA（希腊语检测、拼写检查）
- 自动化套件（诊断、批量操作、账户审计）
- Vault引导（每个客户端15个模板文件）
- 高级测试和评估
高级套餐可单独购买。公共工具在没有它的情况下完全可以工作。
是什么让这与众不同
- 生产测试 涵盖37个以上的客户活动，具有实际预算和实际优势案例
- 不是包装纸 -包括优化引擎、安全门、验证器和回滚
- 保险库集成 -读取客户情报（ICP、品牌声音、角度）以生成更好的广告
- 希腊语QA 内置（适用于任何语言验证）
- 所有广告创建暂停 -未经运营商明确批准，任何内容均不得上线
- 受监督，而非自主 -操作员确认每次写入、每次激活、每次预算更改
工具分类
| 分类 | 计数 | 描述 |
|---|---|---|
| 生产安全 | 38 | 只读数据访问。没有API写入，没有本地状态更改。 |
| 仅受监督 | 29 | 执行前需要操作员批准的写入/删除操作。 |
| 仅供咨询 | 31 | 生成建议、计划、副本、诊断。没有Meta API写入。可以写入本地文件。 |
| 总计：98个已注册 |
建筑
meta_ads_mcp/
core/ # 66 tools - API read/write operations
engine/ # 32 tools - optimization, review, learning, experiments
validators/ # Quality gates (compliance, creative specs, tracking, structure)
safety/ # Rate limiting, rollback, duplicate checking, file locks, tier access
ingestion/ # Internal: video manifest management
reporting/ # Internal: not currently active (see Non-Shipped Code)工具类别
| 类别 | 工具 | 描述 |
|---|---|---|
| 帐户管理 | 6 | 令牌健康、广告帐户、页面、IG身份、发现 |
| 活动 | 4 | 创建、阅读、更新活动 |
| 广告集 | 4 | 创建、阅读、更新具有定位功能的广告集 |
| 广告 | 4 | 创建、阅读、更新广告 |
| 创意 | 3 | 创作、阅读广告创意 |
| 洞察与分析 | 1 | 具有原型感知规范化的性能数据 |
| 像素和跟踪 | 5 | 像素健康、事件诊断、测试事件、CAPI |
| 目录和DPA | 6 | 产品目录、提要、产品集、验证 |
| 受众 | 1 | 自定义受众列表 |
| 目标 | 3 | 兴趣、行为和地理搜索 |
| 视频管理 | 3 | 上传（简单+可恢复）和处理状态 |
| 广告生成器 | 1 | 具有IG门强制功能的多资产广告创建 |
| 复制引擎 | 2 | Vault驱动的广告复制生成和验证 |
| 命名约定 | 1 | 所有对象的强制命名模式 |
| 自动化与诊断 | 6 | 希腊QA、全面诊断、批量操作、账户审计 |
| Vault&Intelligence | 2 | 客户端Vault阅读器，概念选择 |
| 优化引擎 | 4 | 优化周期、启动计划、执行包 |
| 突变走廊 | 2 | 预算/目标变更及验证 |
| 激活和回滚 | 4 | 状态更改和取消飞行前检查 |
| 审查队列 | 7 | 操作员审查队列、结果快照、摘要 |
| 学习层 | 5 | 策略记忆、结果评估、学习周期 |
| 实验 | 7 | A/B测试、预算调节器、创意轮换、缩放 |
| 复制生成 | 2 | 自动复制链，基于vault的希腊语复制 |
发动机特点
- 优化循环 -基于绩效信号的自动预算转移
- 实验管理 -具有统计学意义的A/B测试跟踪
- 预算总监 -通过可配置的每日/终身限制防止超支
- 创意轮换 -疲劳检测和自动创意刷新触发
- 政策学习 -跟踪行动结果，并随着时间的推移调整信心
- 命名大门 -在编写任何API之前严格执行命名约定
安全功能
- 速率限制 -遵守Meta API费率限制，并进行退让
- 回滚 -使用执行日志撤消最近的更改
- 查重 -防止意外的重复活动/广告
- 文件锁 -对vault存储的安全并发访问
- 基于层的访问 -每个帐户的安全级别（沙盒、标准、生产）
验证器套件
- 合规性验证器 -元广告策略预检查
- 创意规格验证器 -图像/视频尺寸和格式验证
- 跟踪验证器 -启动前的像素和事件验证
- 结构验证器 -活动结构一致性检查
- 操作验证器 -预算、进度和目标健全性检查
未发货代码
存在于存储库中但不属于活动工具界面的代码：
- reporting/templates.py、reporting/formatter.py -运行时未导入，未生成活动报告
- 撤离/ -内部评估存根，不面向操作员
- 内部助手 （非MCP工具）：identity.py（IG解析）、api.py（HTTP客户端）、auth.py（令牌验证）、utils.py（格式助手）、safety/（速率限制器、回滚、去重）、验证器/（预写验证管道）
设置
1.安装
cd meta-ads-mcp
uv sync2.环境变量
复制 .env.example 到 .env 并填写您的值：
cp .env.example .env必修的：
META_ACCESS_TOKEN-Meta Marketing API访问令牌（推荐系统用户令牌）
可选：
META_APP_SECRET-适用于appcret_proof（推荐用于生产）META_APP_ID-元应用IDVAULT_PATH-营销保管库目录的路径（默认为~/marketing-vault)
3.MCP配置
添加到您的Claude Code MCP配置中(.mcp.json):
{
"mcpServers": {
"meta-ads": {
"command": "uv",
"args": ["--directory", "/path/to/meta-ads-mcp", "run", "python", "-m", "meta_ads_mcp"],
"env": {
"META_ACCESS_TOKEN": "your_token_here",
"VAULT_PATH": "/path/to/your/marketing-vault"
}
}
}
}4.保险库结构（可选）
如果将vault集成用于客户端智能：
your-vault/
01_CLIENTS/{client-slug}/
00-profile.md # Account IDs, pixel, page, IG
02-icp-personas.md # Target audience profiles
04-brand-voice.md # Tone, language, style rules
05-messaging-house.md # Angles, value props
08-objections.md # Objections + bias deployment
matrix.md # Decision Matrix
02_COMPETITORS/{slug}/
landscape.md # Competitive landscape测试
uv run --extra dev python -m pytest tests/ -v
# Public package: 215 passed | Full (with premium): 246 passed许可证
麻省理工学院-见 许可证.