mcpField
M
meta-ads-expert

meta-ads-expert

github.com/varnan-tech营销与增长68739 次安装2 周前更新
代码仓库

关于 meta-ads-expert

为媒体投放人员提供 Meta Ads CLI 操作路由与安全规则的技能,适用于查询广告账户、广告系列和成效数据,以及创建广告系列。它强调结构化读取、受限分页和日期范围,并要求对更改状态的操作先取得明确确认。

主要功能

  1. 01路由账户、广告系列与广告查询
  2. 02获取广告成效数据
  3. 03读取操作使用 JSON 输出
  4. 04创建操作默认设为暂停
  5. 05状态变更前要求明确确认

适用场景

  1. 01查看广告账户及投放对象
  2. 02获取最近 7 天的成效数据
  3. 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)之前,必须获得用户的明确确认。

  1. 向用户展示准确的 CLI 命令及参数。
  2. 请求明确批准。
  3. 仅在获得批准后继续。

编排工作流

有关复杂编排(例如 CPA 飙升分析),请参阅 references/workflows.md。

有关报告规范和输出模板,请参阅 references/report_templates.md。

评论

支持 Markdown