Meta Ads Expert 是一个面向 Meta Ads CLI 的技能,其角色设定为「专家级媒介买手(Expert Media Buyer)」。它本身是一个路由器,负责提供高层级指令,并链接到详细参考文档,用于通过 meta-ads CLI 与 Meta Ads API 交互。
用途
该技能用于在命令行环境下管理 Meta 广告相关对象与数据,包括账户、广告系列、广告组、广告和洞察(insights)。适用者是需要通过 meta-ads CLI 操作 Meta 广告的媒介买手或运营人员。
认证与设置
Meta Ads CLI 使用 System User Access Token 进行认证。需要确保在运行 CLI 的环境中设置以下环境变量:
- ACCESS_TOKEN:你的 Meta System User Access Token。
- AD_ACCOUNT_ID:目标广告账户 ID(例如 act_123456789)。
关键要求(CRITICAL):绝不要在命令中使用内联 token(例如 meta ads --token <TOKEN>)。始终依赖环境变量或预先配置的配置文件。
CLI 路由
技能提供意图到 meta-ads CLI 命令的映射:
- 列出广告账户:meta ads account list
- 列出广告系列:meta ads campaign list
- 列出广告组:meta ads adset list
- 列出广告:meta ads ad list
- 获取洞察:meta ads insights get
- 创建广告系列:meta ads campaign create
严格防护规则(Strict Guardrails)
命令执行方面:
- JSON 输出:所有读取操作必须始终使用 --output json,以确保输出结构化数据便于分析。
- 禁止交互输入:必须始终使用 --no-input(或等效参数),以防 Bash 工具因交互式提示而挂起。
- 创建安全:除用户明确要求处于启用状态外,所有创建命令必须始终使用 --status PAUSED。
日期范围与分页方面(用于防止上下文窗口溢出和 API 速率限制):
- 分页限制:列出项目时,初始阶段应限制 limit 参数(例如 --limit 10)。仅在明确需要时才扩大。
- 日期范围:获取洞察时,必须始终默认使用 --time-range last_7d。除非用户指示,否则不要请求更大的范围。
安全护栏(状态变更操作)
在执行任何状态变更命令(例如 campaign create、campaign update)之前,必须获得用户的明确确认。流程为:向用户展示确切的 CLI 命令与参数;请求明确批准;仅在批准后才继续执行。
编排工作流
对于复杂编排(例如 CPA 飙升分析),参见 references/workflows.md。 关于报告标准与输出模板,参见 references/report_templates.md。
适用场景与限制
该技能适用于通过命令行对 Meta 广告进行读取与管理操作的场景,以及需要结构化输出进行分析的场景。其限制包括:认证依赖 System User Access Token 与环境变量;读取操作强制 JSON 输出与禁止交互输入;创建操作默认暂停状态;洞察查询默认仅取最近 7 天;列表演示默认限制条目数量;状态变更操作必须先获得用户显式确认。关于具体的安装方式、支持的平台范围、是否收费及价格等信息,资料中暂未提供。