用途：通过 Meta Marketing API 管理 Facebook/Meta 广告，涵盖账户审计、效果报告、状态变更、广告结构创建与更新、定向搜索、素材上传和故障排查。
主要能力：内置 scripts/meta_ads.py 脚本提供 accounts、account、list、get、create、update、set-status、insights、targeting-search、upload、batch、request 等子命令，支持结构化 JSON 输出、dry-run、重试、分页、批量请求与异步 Insights 作业。
环境变量：META_ACCESS_TOKEN（必填）、META_AD_ACCOUNT_ID（可选默认账户）、META_API_VERSION（默认 v25.0）、META_GRAPH_BASE（默认 https://graph.facebook.com）。令牌缺失时应先协助配置，不得编造响应。
安全流程：涉及花费、投放或追踪的变更须先给计划、运行 --dry-run、展示待改对象与字段、等待用户明确批准，再加 --confirm 执行；新建广告默认 PAUSED；写入后需读回验证。避免删除，优先 PAUSED 或 ARCHIVED。预算单位为最小货币单位，写入前核对账户币种与时区。遇到 613 或 80004 限流应暂停并缩小范围或增加重试间隔。
常用示例： python3 scripts/meta_ads.py accounts python3 scripts/meta_ads.py account --fields id,name,account_status,currency,timezone_name,amount_spent,spend_cap python3 scripts/meta_ads.py insights act_123 --level campaign --date-preset last_7d python3 scripts/meta_ads.py set-status 120000000000000 PAUSED --dry-run python3 scripts/meta_ads.py create campaign --params-file assets/campaign-create.json --dry-run python3 scripts/meta_ads.py targeting-search --type adinterest --q "running"
限制：需自备有效访问令牌与权限；定向 ID 不得杜撰，须先经 targeting-search 解析；涉住房、就业、信贷、社会议题、选举或政治等特殊类别需先查 API 指南。