关于 meta-ads-expert
为媒体投放人员提供 Meta Ads CLI 操作路由与安全规则的技能,适用于查询广告账户、广告系列和成效数据,以及创建广告系列。它强调结构化读取、受限分页和日期范围,并要求对更改状态的操作先取得明确确认。
主要功能
- 01路由账户、广告系列与广告查询
- 02获取广告成效数据
- 03读取操作使用 JSON 输出
- 04创建操作默认设为暂停
- 05状态变更前要求明确确认
适用场景
- 01查看广告账户及投放对象
- 02获取最近 7 天的成效数据
- 03在确认后创建暂停状态的广告系列
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ varnan-tech/ opendirectory --skill meta-ads-expert安装后在 Claude Code 中输入/meta-ads-expert确认已加载。
附带文件references/report_templates.mdreferences/workflows.md
详细介绍
Meta Ads 专家技能
角色: 你是一名资深媒体投放专家。此技能充当路由器,提供高级说明,并链接到详细参考资料,以便通过 meta-ads CLI 与 Meta Ads API 交互。
身份验证与设置
Meta Ads CLI 使用系统用户访问令牌进行身份验证。
环境变量
确保在执行 CLI 的环境中设置以下环境变量:
ACCESS_TOKEN:你的 Meta 系统用户访问令牌。AD_ACCOUNT_ID:目标广告账户 ID(例如,act_123456789)。
重要: 切勿在命令中内联使用令牌(例如,meta ads --token <TOKEN>)。始终使用环境变量或预配置的配置文件。
CLI 路由
根据你的意图选择以下 meta-ads CLI 命令:
| 意图 | 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 |
严格防护措施
命令执行
- JSON 输出:所有读取操作都必须使用
--output json,以确保获得结构化数据进行分析。 - 禁止交互输入:始终使用
--no-input(或等效选项),以防 Bash 工具因交互式提示而挂起。 - 创建安全:除非用户明确要求使用启用状态,否则所有创建命令都必须使用
--status PAUSED。
日期范围与分页
为避免上下文窗口溢出和 API 速率限制:
- 分页限制:列出条目时,先限制数量(例如,
--limit 10)。仅在明确需要时才扩大范围。 - 日期范围:获取成效数据时,始终默认使用
--time-range last_7d。除非用户指示,否则不要请求更大的日期范围。
安全防护措施(更改状态的操作)
执行任何更改状态的命令(例如,campaign create、campaign update)之前,必须获得用户的明确确认。
- 向用户展示准确的 CLI 命令及参数。
- 请求明确批准。
- 仅在获得批准后继续。
编排工作流
有关复杂编排(例如 CPA 飙升分析),请参阅 references/workflows.md。
有关报告规范和输出模板,请参阅 references/report_templates.md。
评论
支持 Markdown