📦 Meta Ads CLI - control your ad campaigns — Meta Ads CLI - 控制您的广告活动

v2.0.0

当AI代理需要通过Meta的官方API管理、审计、报告、创建、暂停、更新或排除Meta、Facebook、Instagram广告故障时,请使用此技能。

0· 0·0 当前·0 累计
tristanmanchester 头像by @tristanmanchester (Tristan Manchester)

运行时依赖

无特殊依赖

版本

latestv2.0.0

对于写操作,返回:

安装命令

点击复制
官方npx clawhub@latest install meta-ads-cli
镜像加速npx clawhub@latest install meta-ads-cli --registry https://cn.longxiaskill.com镜像同步中
需要定制?告诉我你的需求 →

技能文档

Meta Ads CLI 代理技能 该技能教会 AI 代理通过 Meta 的官方 Ads CLI 操作 Meta 广告,而不是重新实现 Marketing API。核心命令形状为:meta ads <资源> <操作> [选项] 来自官方 Ads CLI 模式的示例包括: meta ads campaign list meta ads campaign create --name "Summer Sale" --objective OUTCOME_SALES --daily-budget 5000 meta ads adset create CAMPAIGN_ID --name "My Ad Set" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --targeting-countries US meta ads creative create --name "Hero Banner" --page-id 111222333 --image ./banner.jpg --body "50% off" --title "Shop Now" --link-url https://example.com/sale --call-to-action SHOP_NOW meta ads ad create ADSET_ID --name "Hero Banner Ad" --creative-id CREATIVE_ID meta ads insights get --campaign_id CAMPAIGN_ID --fields impressions,conversions,spend --date-preset last_7d 使用捆绑的守护脚本作为默认执行路径: python3 scripts/meta_ads_agent.py doctor python3 scripts/meta_ads_agent.py classify -- meta ads campaign list python3 scripts/meta_ads_agent.py run -- meta ads campaign list --limit 25 守护脚本不替换 Meta 的 CLI,而是包装它,使代理安全一致地运行。 最高优先级规则 首先使用 Meta 的官方 CLI。除非官方 CLI 不能执行任务且用户明确接受较低级别的解决方案,否则不要直接调用 Graph API。 读取前写入。在更改之前检查相关账户/对象/性能状态。 没有用户明确批准的花费影响更改。写入、预算更改、激活、删除/移除、数据集/目录连接和创意上传需要批准。 永远不要意外激活。新的对象应保持暂停状态,除非用户明确要求激活。 ACTIVE、activate、delete、remove 和 --force 是高风险操作。 更喜欢机器可读输出。尽可能使用 JSON:meta --output json ads .... 仅将表格输出用于人类呈现。 一次写入一步。应用一个变异,验证,然后继续。 不要发明 ID。从 CLI 或用户提供的值解析账户、活动、广告集、创意、页面、像素/数据集、目录、产品集和目标 ID。 将令牌保持在聊天和日志之外。永远不要打印访问令牌、应用程序密钥、Cookie 或 .env 内容。 仅在阻塞时请求缺失的材料。对于读取操作,使用默认值。对于写入操作,收集确切的账户、ID、预算、日期范围、页面/数据集/目录、目标 URL 和批准。 谨慎处理受监管的/特殊类别。住房、就业、信用、政治、社会问题、健康、金融服务、未成年人和敏感受众需要额外的审查和保守的定位。 推荐的代理流程 几乎每个请求都遵循此顺序:

  • 分类请求:只读、普通写入、预算/写入、激活、破坏性、受监管。
  • 如果账户访问不确定,则运行 doctor/auth 检查。
  • 使用紧凑的 JSON 输出读取当前状态。
  • 生成一个包含确切命令、风险、假设和验证命令的简短计划。
  • 对于只读任务:运行命令并总结。
  • 对于写入操作:等待明确批准,然后运行脚本/ meta_ads_agent.py。
  • 在每次写入后验证状态。
  • 报告更改、对象 ID、之前/之后的值和任何未解决的问题。
安装和身份验证检查清单 # Meta 文档将 meta-ads 列为包名称。 python3.12 -m pip install meta-ads # 确认 CLI 可用。 meta --help meta ads --help # 身份验证状态。 Meta 文档显示 ACCESS_TOKEN 用于基于令牌的身份验证。 export ACCESS_TOKEN= meta auth status # 更喜欢每个命令的显式广告账户,直到默认值被证明。 meta ads --ad-account-id campaign list 如果身份验证失败,请不要猜测配置密钥。 运行: meta auth status meta ads --help meta ads <资源> --help 然后按照官方 CLI 设置/配置文档进行安装版本。 使用守护脚本 检查就绪状态 python3 scripts/meta_ads_agent.py doctor 分类命令风险而不执行 python3 scripts/meta_ads_agent.py classify -- meta ads campaign update 123 --status ACTIVE 运行只读命令 python3 scripts/meta_ads_agent.py run -- meta ads campaign list --limit 25 在批准后运行写入操作 python3 scripts/meta_ads_agent.py run \ --approved "用户批准在账户 act_123 中创建暂停活动 Summer Sale" \ -- meta ads campaign create --name "Summer Sale" --objective OUTCOME_SALES --daily-budget 5000 在更强的批准后运行激活 python3 scripts/meta_ads_agent.py run \ --approved "用户批准在查看后激活活动 123" \ --allow-active \ -- meta ads campaign update 123 --status ACTIVE 检查或运行多步骤计划 python3 scripts/meta_ads_agent.py lint-plan templates/weekly-report-plan.json python3 scripts/meta_ads_agent.py run-plan templates/weekly-report-plan.json 写入密集型计划需要 --app

数据来源ClawHub ↗ · 中文优化:龙虾技能库