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）以驗證邏輯，避免影響即時廣告成效。