SuperAPI AI 工具集

pp-meta-ads

编程与开发

查看项目

更新于 10-16 01:32

技能介绍

Meta Ads — Printing Press CLI(技能名 pp-meta-ads)是一个面向智能体的 Meta 广告只读命令行工具,二进制为 meta-ads-pp-cli,带本地 SQLite 历史,可执行实时 API 难以回答的复合查询。

用途:跨 Meta 广告账户做创意疲劳诊断、受众重叠测绘、学习期取证和归因漂移检测。适合配合每日同步到本地库,使趋势查询即时返回。

安装:默认通过 npx -y @mvanhorn/printing-press-library install meta-ads --cli-only;失败时可用 go install github.com/mvanhorn/printing-press-library/library/marketing/meta-ads/cmd/meta-ads-pp-cli@latest(需 Go 1.26.6+)。验证:meta-ads-pp-cli --version,并确保安装目录在 PATH 中。

主要能力:fatigue(检测 CPM 上升、频次攀升、CTR 下降的广告);decay(比较创意首次展示 CTR 与当前 CTR,给出预计失效日期);overlap(自定义受众两两重叠率与自噬建议);learning(找出学习期超过 N 天的广告组及原因提示);reconcile(账户报告花费与 insights 花费的逐日差异);bottleneck(高花费低 ROAS 广告组排名);stale(N 天零展示的活跃广告);inventory(按 effective_status 分组,暴露配置为 ACTIVE 但实际 WITH_ISSUES 或 DISAPPROVED 的广告)。另有 ads、adsets、campaigns、customaudiences、insights、me 等读取命令,以及 which 自然语言查找命令。

使用方式:先用 META_ACCESS_TOKEN 环境变量认证,建议只授予 ads_read 权限,切勿使用 ads_management 等写权限;运行 meta-ads-pp-cli doctor 验证。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。输出含 meta(source 为 live 或 local)与 results 外壳,解析 .results 取数据。支持 --select 字段裁剪、--dry-run 预览、--deliver 输出到 stdout/file/webhook、命名 profile 与本地 feedback 记录。还提供 MCP 服务器(go install .../meta-ads-pp-mcp@latest 并用 claude mcp add 注册)。

限制:只读,不能创建、暂停、修改或删除广告系列、广告组、广告、受众或创意,也不做预算与出价策略更改、受众上传。用量与价格信息资料未提供。