메뉴
分析 Amazon Ads search term report（SP / SB / SD），识别候选 ASIN、报告类型、低效词、放量词、属性词、场景词和趋势变化。 使用时机：用户上传广告搜索词报告，想判断哪些 search term 应该观察、控 bid、否定候选、继续放量，或想把搜索词里的用户需求反馈到 Listing 与投放策略时调用。 触发词：/zach-search-term-report-analyzer
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/aiskillstore/marketplace --skill zach-search-term-report-analyzer명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Maintain a portable task-state ledger for long, multi-step work. Use when a task spans many files, produces large logs, needs a reliable handoff, or requires traceable evidence without repeatedly loading full outputs. Creates concise state records and private evidence references with explicit limits, redaction checks, and retention guidance.
【收纳储物必看】装修前不会规划收纳，入住半年家变仓库？这个 Skill 内置装修课堂会员版「家居收纳储物方法」152篇原创知识库，专门讲收纳储物——收纳是家的骨架、柜子不是越多越好、收纳本质是把东西藏起来、收纳加勤快缺一不可。问玄关鞋柜怎么装、问厨房9个收纳位置、问衣柜衣帽间怎么做、问小户型怎么榨干每1平米、问收纳避坑和鸡肋神器，全部覆盖。适合正在装修、准备收纳规划、家里东西多总是乱、想做满墙柜/通顶柜/800库的业主。
【儿童房装修必看】家里有小孩、正准备要孩子、或想给儿童房做环保安全装修？这个 Skill 内置装修课堂知识库，专门讲"适童化"——儿童是最易受甲醛伤害的人群，儿童房必须实木/ENF/控总量。问儿童房怎么装环保、问儿童房墙面地面用什么、问儿童家具选实木还是人造板、问孩子学习/游戏专区怎么规划、问有娃家庭怎么防磕碰防污染，全部覆盖。适合家里有娃、备孕婚房、想装出健康儿童房的业主。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | zach-search-term-report-analyzer |
| description | 分析 Amazon Ads search term report（SP / SB / SD），识别候选 ASIN、报告类型、低效词、放量词、属性词、场景词和趋势变化。 使用时机：用户上传广告搜索词报告，想判断哪些 search term 应该观察、控 bid、否定候选、继续放量，或想把搜索词里的用户需求反馈到 Listing 与投放策略时调用。 触发词：/zach-search-term-report-analyzer |
| benefits-from | [] |
| user-invocable | true |
| allowed-tools | ["Read","Write","Edit","Bash","Glob","Grep"] |
| risk-level | medium |
本公开版 Skill 是自包含的，不依赖私有工作区文件、内部知识库、店铺配置或团队数据源。
开始执行前，建议先读取本 Skill 自带材料：
references/field_mapping.md — SP / SB / SD 字段映射references/decision_rules.md — 搜索词决策规则references/term_classification.md — 品牌词、竞品词、属性词、场景词分类口径references/output_template.md — 报告与 CSV 输出模板scripts/clean_search_term_report.py — 原始报表清洗与标准化脚本scripts/analyze_search_term_decisions.py — 单 ASIN 决策分析脚本scripts/fetch_listing_context.py — 可选的 Amazon 前台 Listing 上下文抓取脚本广告搜索词报告不只用来找否词。它同时承担三件事：
本 Skill 输出的是分析建议和行动候选，不会替用户直接修改广告、预算、出价或否词设置。
| 参数 | 必须 | 默认值 | 说明 |
|---|---|---|---|
| 搜索词报告文件 | 是 | - | CSV / XLSX / XLSM / XLS，优先使用 Amazon Ads 官方导出文件 |
| 品牌 | 否 | 报表字段或文件名识别 | 也可用 --brand 显式指定 |
| ASIN | 否 | 自动识别单一候选 | 多个候选时必须让用户选择一个 |
| 站点 | 否 | US | 用于可选 Listing 抓取 |
| 报告类型 | 否 | 自动识别 | SP / SB / SD；识别失败时标记 UNKNOWN |
| 目标 ACOS | 否 | 报表自身基准 | 用 --target-acos 0.20 显式传入更稳 |
| Listing 上下文 | 否 | 默认尝试 live fetch | 可用 --listing-context-file 提供本地标题/卖点文本 |
python3 skills/zach-search-term-report-analyzer/scripts/clean_search_term_report.py <input_file>
--brand 显式传入；品牌只用于分组、文件命名和品牌词识别。按 references/field_mapping.md 将原始字段统一为内部字段：
datebrandasincampaign_namead_group_nametargetingmatch_typesearch_termimpressionsclicksspendorderssalescvracosroas缺失字段按“有就用，没有就跳过”处理；但核心字段 date + search_term + clicks + spend 缺失时必须停止。
orders / clicks。--target-acos，用它判断成本压力；否则使用该 ASIN 报表自身 ACOS 作参考。默认行为：脚本会尝试按 ASIN 和站点访问 Amazon 前台页面，提取 title / bullets / description / breadcrumb。
稳定测试或网络受限时使用：
--skip-live-listing-fetch
--listing-context-file skills/zach-search-term-report-analyzer/examples/listing-context-sample.md
Listing 上下文只用于增强“相关词、属性词、场景词、弱相关词”的判断；抓取失败不能阻断基础广告分析。
读取 references/decision_rules.md 和 references/term_classification.md，为每个 search term 输出：
brand_term / competitor_term / asin_term / core_category_term / attribute_term / scenario_term / irrelevant_term / uncertain_termscale_up / hold_test / reduce_bid / negative_candidate / observe / listing_feedback / manual_reviewhigh / medium / low默认输出到：
outputs/search-term-report-analyzer/{brand_or_unknown}/
脚本命令示例：
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
| 文件 | 格式 | 路径 |
|---|---|---|
| 主报告 | .md | outputs/search-term-report-analyzer/{brand}/{YYYY-MM-DD}_{brand}_{asin}_7-14-30天_搜索词报告分析.md |
| 明细表 | .csv | outputs/search-term-report-analyzer/{brand}/{YYYY-MM-DD}_{brand}_{asin}_7-14-30天_搜索词分析明细.csv |
| 异常清单 | .csv | outputs/search-term-report-analyzer/{brand}/{YYYY-MM-DD}_{brand}_{asin}_7-14-30天_异常清单.csv |
| 运行摘要 | .json | outputs/search-term-report-analyzer/{brand}/{YYYY-MM-DD}_{brand}_{asin}_7-14-30天_run_summary.json |
报告完成状态：
告知用户：