meta

Meta 营销 CLI 为与 Meta Graph API 交互提供了强大的命令行接口。此工具专为开发人员与营销自动化工程师设计，简化了广告账户管理、广告活动编排与 Instagram 内容排程等复杂工作流程。该工具采用“故障停止”（fail-closed）策略，若缺少必要输入或 API 请求发生错误，执行将立即停止，以确保高度的运行可靠性，防止在 Meta 环境中发生预算溢出或配置错误。

• 完整的 Meta 广告生命周期管理，包括创建、读取、更新及审核广告活动、广告组合与单一广告。

• 自动化洞察报告功能，支持多种聚合层级、指标与日期预设，并输出为适合后续数据分析的 JSONL 或表格格式。

• Instagram 发布能力，允许开发人员将媒体直接推送到动态，并使用幂等键（idempotency keys）防止重复发布。

• 基于架构（Schema）的验证流程，确保所有负载字段与参数结构在提交前均符合 Meta 当前的 API 规范。

• 支持人工介入的认证引导，通过可配置的 HTTPS 回调端点处理 OAuth 流程，以实现安全的令牌交换。

• 用户必须通过 meta auth setup 命令初始化认证，并确保重定向 URI 与 AI 主机回调完全匹配。

• 在执行任何变更操作前，务必执行 meta schema sync 以确保本地定义与当前的 Meta Graph API 版本同步。

• 所有涉及预算的操作皆需通过明确的确认标记（flag），以防止未经授权的财务支出。

• 与其他脚本集成时，请使用机器可读的标记（--output json 或 --format jsonl）以最大化自动化效率。

• 系统会自动对命令记录中的 APP_SECRET 与访问令牌（Access Tokens）进行遮蔽，以增强安全性。

• 在测试广告创建或预算调整时，优先使用干运行模式（--dry-run）以验证逻辑，避免影响即时广告成效。