meta-business

📱 Meta 全平台自动化 CLI 工具箱

基于 Meta Graph API 的 CLI 自动化工具,支持 WhatsApp、Instagram、Facebook 四大平台消息发送、内容发布与数据分析,适合开发者集成社交媒体工作流。

收藏
5.4k
安装
1.2k
版本
v1.2.0
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

核心用法

Meta Business CLI 是一款面向开发者的命令行工具,通过 Meta Graph API 实现 WhatsApp Business、Instagram、Facebook Pages 和 Messenger 的自动化管理。用户需先完成 OAuth PKCE 认证流程,配置应用 ID、密钥及各平台的业务账号 ID,即可通过 meta 命令执行各类操作。

WhatsApp 场景:支持发送文本、图片、文档、模板消息,管理媒体文件(上传/下载/获取 URL),以及查看 30 天内的消息分析数据。模板消息需预先在 Meta 后台创建,适合营销通知类场景。

Instagram 场景:支持发布图片、视频及 Reels,查看账号与单条内容的洞察数据,管理评论(回复、隐藏、删除)。注意发布内容需提供公开 URL,不支持本地文件直接上传。

Facebook Pages 场景:创建图文或链接动态,查看帖子列表与页面洞察数据。

Messenger 场景:向指定 PSID 发送文本或图片消息,支持消息标签突破 24 小时会话窗口限制,可查看对话列表与详情。

Webhook 场景:启动本地监听器接收实时事件(如消息、评论),支持事件订阅与验证。

所有命令均支持 --json 输出结构化数据,便于集成到自动化脚本。meta doctor 命令可一键诊断配置完整性。

显著优点

1. 一站式多平台覆盖:单一 CLI 工具打通 Meta 四大核心业务平台,无需切换多个 SDK 或管理不同认证体系。

2. 标准化输出--json 标志确保所有命令返回结构化数据,方便与 CI/CD 流水线、数据分析工具对接。

3. 安全认证设计:采用 OAuth PKCE 流程,令牌本地存储,支持 --token 临时覆盖,避免硬编码敏感信息。

4. 完善的诊断机制meta doctor 预检配置、凭据、权限及 API 连通性,降低首次使用门槛。

5. 非交互式友好:所有命令支持纯 flag 传参,适合无人值守的自动化场景。

潜在缺点与局限性

1. 外部依赖前置:需用户自行通过 bun/npm 安装 meta-business-cli,Skill 本身仅为使用文档,不捆绑可执行文件。

2. Instagram 发布限制:图片/视频需托管于公开 URL,无法直接上传本地文件,增加了内容准备步骤。

3. WhatsApp 模板门槛:发送模板消息需预先在 Meta Business Manager 中创建并审核,无法即时自定义内容。

4. Messenger 24 小时窗口:常规消息受限于用户最后互动时间,需借助消息标签(如 HUMAN_AGENT)才能主动触达,标签类型受限且需合规使用。

5. API 版本锁定风险:默认使用最新 Graph API 版本,虽支持 --api-version 固定版本,但 Meta 的 API 变更策略可能导致长期维护成本。

适合的目标群体

  • 社交媒体运营团队:需要批量发布内容、自动化回复、监控数据的技术型运营人员。
  • 开发者与 DevOps 工程师:构建客服机器人、营销自动化、内部消息通知系统的后端开发者。
  • SaaS 产品团队:集成 WhatsApp Business API 或 Instagram 发布功能到自身产品的创业公司。
  • 数据分析师:定期拉取多平台洞察数据,生成统一报表的分析师。

使用风险

  • 凭据泄露风险meta config set 将敏感信息存储于本地,多用户服务器环境需额外注意文件权限管理。
  • Webhook 暴露风险:本地启动 meta webhook listen 需配合内网穿透工具(如 ngrok),公网暴露端口可能遭受伪造请求攻击,务必配置 --verify-token--app-secret 验证签名。
  • API 配额与计费:WhatsApp Business API 按会话计费,高频自动化可能产生意外费用,需监控用量。
  • 平台政策合规:Meta 对消息标签使用、营销内容有严格政策,违规可能导致账号限制。
  • 依赖项维护meta-business-cli 的更新节奏与安全补丁需用户主动关注,Skill 文档不会同步推送更新通知。

安全解读

核心用法

Meta Business CLI 是基于 Meta Graph API 的命令行工具,支持四大平台的自动化操作。首次使用需执行 meta config set 配置应用凭证,通过 meta auth login 完成 OAuth PKCE 授权流程,最后以 meta doctor 验证环境就绪。

WhatsApp Business:支持消息发送(文本、图片、文档、模板消息)、媒体管理(上传/下载/获取URL)、模板管理(列出/获取/删除)及分析数据查看。需注意必须预先配置 phoneNumberIdbusinessAccountId

Instagram:覆盖图片/视频/Reel发布、账户与内容洞察分析、评论管理(列表/回复/隐藏/删除)。发布媒体要求提供公开URL,不支持本地文件直接上传。

Facebook Pages:可创建纯文本或链接帖子、列出历史内容、查看页面洞察数据。

Messenger:支持向指定PSID发送文本或图片消息,含消息标签功能以突破24小时会话窗口限制;支持会话列表查看与单会话详情获取。

Webhook:内置本地监听服务器,支持验证回调、订阅事件,便于开发实时消息处理服务。

显著优点

  • 官方生态集成:直接调用 Meta Graph API,功能覆盖全面,API 版本可锁定(如 --api-version v22.0
  • 非交互式友好:所有命令支持 --json 结构化输出和完整参数化调用,完美适配 CI/CD 和自动化脚本
  • 统一凭证管理:配置文件集中存储,支持 --token 临时覆盖,便于多环境切换
  • 诊断工具完善meta doctor 一站式检测配置、凭证、权限及资产可访问性

潜在局限

  • 前置配置复杂:WhatsApp 需额外申请商业账号,Instagram 发布依赖外部托管的媒体URL
  • 平台政策约束:Messenger 消息标签使用受限,WhatsApp 模板需预审核,违规可能导致账号限制
  • 无本地媒体上传:Instagram 和 WhatsApp 媒体均需先托管至公网URL,增加流程步骤
  • 速率与配额限制:受 Graph API 配额管控,大规模运营需申请额度提升

适合人群

  • 社交媒体运营团队的技术负责人
  • 需要批量管理多平台账号的开发者
  • 构建客服自动化或营销工作流的工程师
  • 已有 Meta 开发者账号并熟悉 OAuth 流程的技术用户

常规风险

| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | `app.secret` 和访问令牌需妥善保管,避免硬编码至版本库 |
| 消息合规 | WhatsApp 商业消息需用户主动触发会话,滥用模板消息可能被封禁 |
| API 变更 | Meta 频繁更新 API 版本,需关注弃用公告及时迁移 |
| 数据隐私 | 处理用户消息内容时需遵守 GDPR/CCPA,建议启用端到端加密审计日志 |

建议生产环境使用专用 Business Manager 账号,配合最小权限原则配置应用权限范围。

meta-business 内容

手动下载zip · 2.0 kB
SKILL.mdtext/markdown
请选择文件