SuperAPI AI 工具集

meta-ad-builder

营销与增长

查看项目

更新于 10-16 03:37

技能介绍

用途:把已完成的创意(通常是本工作区中生成式 AI 技能的产出)转化为 Meta(Facebook/Instagram)线上广告。该技能覆盖三个阶段:调研(可选)、文案、部署,通过移植并参数化的 Python 脚本直接调用 Meta Marketing API。

主要能力:

  • 调研:排名账户内广告并拉取高表现文案(python scripts/pull-top-ads.py --date-preset last_30d --min-spend 100 --limit 15);从广告库拉取竞品广告(python scripts/pull-competitor-ads.py --pages "BrandName" --limit 50)。输出 JSON 到 OUTPUT_BASE 或 ./outputs/meta-ads/。
  • 文案:按 copy-guide.md 写 copy.json,含 5 个正文、5 个标题、3 个描述,可模仿高表现广告的语气与模式。
  • 部署:先试运行打印创意载荷而不调用 API(python scripts/deploy-ad.py --dry-run --adset-id <AD_SET_ID> --copy-file copy.json --link <DESTINATION_URL> --image path/to/creative.png),确认后再正式部署,用 --video 可传多个视频,每个成为独立广告。

前置条件:在 .env 中配置 META_ACCESS_TOKEN(必填,需 ads_management 权限)、META_AD_ACCOUNT_ID(必填),可选 META_PAGE_ID、META_IG_USER_ID、META_PIXEL_ID、META_API_VERSION;安装依赖 python3 -m pip install -r scripts/requirements.txt;需已存在目标广告组;需磁盘上的真实创意文件路径。运行 bash scripts/check-meta-env.sh 校验凭据。

限制:仅创建广告,不创建或编辑广告系列、广告组、预算或受众;所有广告创建后为暂停状态,需在 Meta Ads Manager 中审核并取消暂停,技能不会自动启动花费;本技能不用于生成创意,也不用于写 AdTable/Airtable 行。视频处理为异步,部署可能需数分钟,视频会上传轮询至处理完成。API 调用本身免费,广告花费为真实费用,但因全部暂停故在取消暂停前不产生花费。特殊广告类别(信贷、就业、住房、社会议题)会改变广告组定位规则,需向用户提示。账户相关数据通过 outputs/ 输出且被 gitignore 忽略。