SuperAPI AI 工具集

ad-upload

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:作为 Meta Ads Copilot 生态的下游环节,把 ad-copy-generator 产出的 asset_feed_spec JSON 与图片推送到 Meta 广告账户。

主要能力:四步上传链——校验文案与图片、生成 dry-run 产物(含将发送的 JSON 与命名预览,不调 API)、通过官方 Ads CLI 创建/上传创意、仅在明确批准后创建 PAUSED 广告。支持单图与批量上传、asset_feed_spec(Degrees of Freedom,多标题/正文/图片组合)、给现有广告替换创意以保留广告 ID 与历史数据、批量上传 batch-upload.json。内置校验规则:标题≤40 字符(50 硬停)、正文 50–500 字符、描述≤30 字符、标题与正文各 1–5 个、CTA 须为合法 Meta 类型;图片须 JPG/PNG、<30MB、≥600×600、推荐 1080×1080 或 1080×1350,比例限 1:1/4:5/16:9/9:16,文字覆盖>20% 会告警。

使用方式:先配置官方 Ads CLI 鉴权,例如 export ACCESS_TOKEN 与 AD_ACCOUNT_ID,然后运行 ./scripts/meta-kit.sh doctor 与 meta ads adaccount list 验证;账户信息可写入 workspace/brand/stack.md。校验可用 identify 或 Python PIL 读取图片尺寸。任何操作加 --dry-run 可先看将发送内容。上传顺序为图片(adimages 接口换取 hash)、创意(adcreatives + asset_feed_spec)、广告(ads,status 固定为 PAUSED),审查后再激活。结果写入 workspace/campaigns/{name}/ads/{creative}.upload.json 并追加到 workspace/brand/assets.md。

适用场景:已有文案与图片、需要按官方 CLI 流程批量创建 Meta 广告、刷新失效创意的投放人员。

限制:需要系统用户令牌含 ads_management 等权限与有效 Facebook Page ID,缺少则创意创建失败;受 Meta 评分制速率限制,遇 294 需退避重试;部分字段/功能官方 CLI 未暴露时才回退 Graph API;官方资料未提供具体价格、收费方式与效果保证。