📦 Facebook Ads
v1.0.4Meta (Facebook) Ads 集成。管理 Campaigns、Audiences、Pixels。用于用户需要与 Meta (Facebook) Ads 数据交互时。
运行时依赖
安装命令
点击复制技能文档
Meta(Facebook)Ads Facebook Ads 是在 Facebook 和 Instagram 创建并管理广告活动的平台。各种规模的企业用它按人口属性、兴趣和行为触达目标受众。平台支持精细的广告定制、追踪与报告。 官方文档:https://developers.facebook.com/docs/marketing-apis
Meta(Facebook)Ads 概览 Campaign Ad Set Ad Ad Account Insights
使用 Meta(Facebook)Ads 本技能通过 Membrane CLI 与 Meta(Facebook)Ads 交互。Membrane 自动处理身份验证与凭证刷新,让你专注集成逻辑,而非鉴权细节。
安装 CLI 安装 Membrane CLI,以便在终端运行 membrane: npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=
交互环境会打开浏览器;无头环境则打印授权 URL。
无头环境:命令打印授权 URL,请用户在浏览器打开;完成后看到验证码,执行:
membrane login complete
任何命令加 --json 可输出机器可读 JSON。
Agent 类型:claude、openclaw、codex、warp、windsurf 等,用于优化工具以适配你的 harness。
连接 Meta(Facebook)Ads
用 membrane connection ensure 按应用 URL 或域名查找或创建连接:
membrane connection ensure "" --json
用户在浏览器完成授权,输出含新连接 id。
返回状态若为 "READY",跳到步骤 2。
1b. 等待连接就绪
若状态为 BUILDING,轮询直到就绪:
npx @membranehq/cli connection get --wait --json
--wait 最长轮询 --timeout 秒(默认 30),直到状态变化。
结果状态说明:
READY — 连接完成,跳到步骤 2。
CLIENT_ACTION_REQUIRED — 需用户或代理操作,clientAction 对象说明:
clientAction.type — 动作类型:"connect"(需授权)、"provide-input"(需补充信息)。
clientAction.description — 可读说明。
clientAction.uiUrl(可选)— 预建 UI 地址。
clientAction.agentInstructions(可选)— 给 AI 代理的编程指引。
用户完成后,再次轮询:membrane connection get --json,确认状态变为 READY。
CONFIGURATION_ERROR 或 SETUP_FAILED — 出错,查看 error 字段。
搜索操作
用自然语言描述需求,搜索可用操作:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
务必在特定连接上下文中搜索。结果含 id、name、description、inputSchema、outputSchema。
常用操作
Name | Key | Description
列出推广活动 | list-campaigns | 列出广告账户下的推广活动
列出广告组 | list-ad-sets | 列出广告账户下的广告组
列出广告 | list-ads | 列出广告账户下的广告
列出广告创意 | list-ad-creatives | 列出广告账户下的广告创意
列出自定义受众 | list-custom-audiences | 列出广告账户下的自定义受众
列出广告账户 | list-ad-accounts | 列出授权用户可访问的所有广告账户
获取推广活动 | get-campaign | 获取指定推广活动详情
获取广告组 | get-ad-set | 获取指定广告组详情
获取广告 | get-ad | 获取指定广告详情
获取广告创意 | get-ad-creative | 获取指定广告创意详情
获取自定义受众 | get-custom-audience | 获取指定自定义受众详情
创建推广活动 | create-campaign | 在广告账户内新建推广活动
创建广告组 | create-ad-set | 在广告账户内新建广告组
创建广告 | create-ad | 在广告账户内新建广告
创建广告创意 | create-ad-creative | 在广告账户内新建广告创意
创建自定义受众 | create-custom-audience | 在广告账户内新建自定义受众
更新推广活动 | update-campaign | 更新现有推广活动
更新广告组 | update-ad-set | 更新现有广告组
更新广告 | update-ad | 更新现有广告
删除推广活动 | delete-campaign | 删除指定推广活动