用途：通过 Meta Marketing API 拉取并分析 Meta 广告（Facebook、Instagram、Messenger、Click-to-WhatsApp、Threads）表现，并在用户明确确认后写回变更（暂停、改预算、复制、含图片与文案的完整建活动）。
主要能力：读取类脚本包括 auth_check.py（验证令牌与可见账户）、list_accounts.py（发现账户并显示花费）、list_campaigns.py、fetch_insights.py（日期范围、多维度拆分、账户/活动/广告组/广告层级）、creative_fatigue.py（频次与 CTR 衰减）、anomaly_detect.py（区间对比异常）、exchange_token.py（换取 60 天长期令牌）。写入类脚本包括 pause_ad.py、update_budget.py、duplicate_ad.py、create_campaign.py、rollback_creation.py。所有脚本输出结构化 JSON。
使用方式：先运行 python scripts/auth_check.py、python scripts/list_accounts.py --with-recent-spend、python scripts/list_campaigns.py。依赖仅 requests，按系统安装：macOS/Linux 用 python3 -m pip install --user requests（Debian/Ubuntu 22+ 加 --break-system-packages），Windows 用 python -m pip install --user requests。需配置 META_ACCESS_TOKEN、META_AD_ACCOUNT_ID（格式 act_1234567890）、META_API_VERSION（默认 v25.0）。令牌分 System User（不过期）与长期用户令牌（60 天）两种路径。
适用场景：广告表现查询、创意健康度、受众与版位分析、活动管理、从零搭建活动或 A/B 测试。
限制：Meta 洞察 API 仅提供最近 37 个月数据，更早活动返回错误 3018；部分执行环境会因代理阻断 graph.facebook.com，需在用户本机运行；Click-to-WhatsApp 并非独立广告面，无独立仪表盘；写入操作涉及真实花费，每次需单独明确确认，预算单次调整不超过 +50%；create_campaign.py 仅支持单图链接广告，不支持动态创意、目录广告、集合广告；不支持初始授权、像素/Conversions API 事件接入、自定义受众创建及就地编辑已上线创意；多租户/代理场景需另行构建。