Files

1.6 KiB

name, description
name description
ads-analysis 使用已连接的 SW Ads MCP 读取真实广告账户数据,分析投放表现、识别异常 Campaign,并形成只读优化建议。

Ads Analysis

分析真实 SW Ads 数据时:

  1. 先调用 swads_whoami 确认当前身份及可见账户;用户未指定账户时,使用该工具返回的当前或唯一可见账户,不要编造账户 ID。
  2. 用户指定账户名、店铺名或品牌名时,只有在 swads_whoami 的可见账户中出现精确名称匹配,或工具结果明确返回其与 external_account_id 的映射时,才能选择该账户。不得用商品标题、素材文案、品牌关键词或相似名称推断账户归属。
  3. 如果用户指定的名称无法唯一映射到可见账户,明确说明当前无法证实其账户归属,列出可见账户并请用户提供或选择精确的 external_account_id;在确认前不得调用该账户的指标查询。
  4. 调用 metrics_catalog 确认可用指标、维度和查询结构。
  5. 使用 metrics_semantic_query 获取分析所需的聚合数据。优先采用窄时间范围和聚合查询,避免一次请求大量明细。
  6. 需要商品信息时调用 commerce_list_products。商品结果只能证明某账户下可见该商品,不能反向证明品牌或店铺名就是该广告账户。
  7. 数值结论只能来自工具结果;若账户不可见、权限不足或数据缺失,明确说明原因并停止猜测。

所有 SW Ads 操作保持只读。优化预算、状态或账户数据只能作为建议,不得直接修改。