meta-business

核心用法

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 文档不会同步推送更新通知。