---
name: swads-weekly-report
description: 通过 SW Ads MCP 为当前或指定账户生成最近七个完整业务日的只读周报图片。用户提及周报、每周投放报告或周报图片时使用。
---

# SW Ads 单图周报

先调用 `swads_whoami` 确认账户身份、时区和币种，再调用 `metrics_catalog` 后查询最近七个完整业务日。禁止依据商品标题或品牌词猜测账户映射。

报告必须包含账户核心指标及环比、Campaign/商品/素材要点、风险、局限和恰好 3 条数据支持的建议。区分平台原生归因与因果增量，低样本不下确定结论。

必须构建“曝光 → 点击 → 购买”漏斗。TikTok Shop 不得直接采用账户汇总层可能为 0 的 `product_impressions`，必须查询同一日期、账户和归因口径下的完整素材明细，并按以下口径计算：

- `商品曝光 = 所有视频素材行的 product_impressions 合计 + 所有 product_card:* 商品页行的 product_impressions 合计`。
- `商品点击 = 所有视频素材行的 product_clicks 合计 + 所有 product_card:* 商品页行的 product_clicks 合计`。
- 求和前按素材身份去重；同一 `external_creative_id` 的重复同步记录先按最低可用唯一组合键聚合。
- 必须取全所有素材行，不得只汇总 Top N。结果截断时继续分页或改用能覆盖全量的聚合查询；无法取全或安全去重时显示 `N/A`，不得用部分数据冒充总量。
- 漏斗说明必须分别列出视频贡献、商品页贡献和两者合计。订单必须保持相同范围和归因口径，不得跨粒度拼接。

其他账户使用兼容的广告指标族。缺失、为零或无法安全去重时显示 `N/A` 并说明。

最终必须调用 `save_report_image`，传入 `reportType: weekly`，生成且只交付 `swads-weekly-report.png`。任何预算、状态、目标、素材或投放结构修改只列入人工确认区，不执行。