用途:读取 Amazon Ads 搜索词报告,按单个 ASIN 分析搜索词表现,输出否定候选、控 bid 候选、放量候选和 Listing 反馈词,帮助人工决策,不直接修改广告出价、预算、否词或结构。
主要能力:识别 SP/SB/SD 报告类型、品牌与 ASIN 候选;将原始字段标准化为 date、search_term、impressions、clicks、spend、orders、sales、cvr、acos、roas 等;建立近 30 天 CVR 基准,聚合 7/14/30 天窗口与趋势;按规则为每个搜索词给出主分类(品牌词、竞品词、ASIN 词、核心类目词、属性词、场景词、无关词、不确定)、动作标签(scale_up、hold_test、reduce_bid、negative_candidate、observe、listing_feedback、manual_review)及置信度与解释。
使用方式:先读取自带 references(字段映射、决策规则、词分类、输出模板)和 scripts。清洗命令:python3 skills/zach-search-term-report-analyzer/scripts/clean_search_term_report.py <input_file>;分析命令:python3 skills/zach-search-term-report-analyzer/scripts/analyze_search_term_decisions.py <input_file> --brand ExampleBrand --asin B0PUBLIC01 --target-acos 0.20 --listing-context-file skills/zach-search-term-report-analyzer/examples/listing-context-sample.md --skip-live-listing-fetch。输出到 outputs/search-term-report-analyzer/{brand}/,含主报告 .md、明细 .csv、异常清单 .csv 和 run_summary.json。可选抓取 Amazon 前台 Listing 上下文,失败不阻断基础分析。
适用场景:单 ASIN 搜索词复盘、否词与控成本候选筛选、放量词发现、属性词与场景词提炼及 Listing 优化反馈。
限制:核心字段缺失时停止;多 ASIN 混在同一报告、品牌/竞品/ASIN 词策略不明、Listing 抓取失败且词义依赖卖点、点击花费过低或时间窗信号冲突时需人工复核;所有广告动作需用户确认后手动执行。