ahang1598 适用场景
输入一个品类关键词，自动完成关键词验证、类目定位、多源数据采集与多维度分析，输出一份按数据源分节的综合市场洞察 HTML 报告。
| 场景 | 说明 |
|---|---|
| 判断一个产品所在的赛道值不值得进入 | 卖家已有目标产品或 ASIN，需全面评估其所在品类的市场容量、竞争格局、新品友好度、利润空间，决定是否入场 |
| 判断一个关键词市场值不值得进入 | 卖家发现某个搜索词/品类词，需验证该关键词背后的真实市场大小、垄断程度和准入门槛 |
| 竞品格局定期复查 | 已涉足品类的卖家定期复查竞争态势变化（建议搭配定时任务周期执行） |
不适用
- 只查单个 ASIN 的详情或销量 → 直接用
linkfox-keepa-product-request或linkfox-amazon-product-detail - 只查关键词搜索量 → 直接用
linkfox-aba-intelligent-query - 一次性快速问答（"这个品类大概多大"）→ 直接用极目或卖家精灵单次查询回答
- 批量多品类同时分析 → 本 skill 每次只处理一个品类关键词，执行时间长（10-15 分钟）、内容多。如果用户输入多个关键词或多个 ASIN，建议分批次做定时任务查询（使用
linkfox-task-scheduler），不要在单次会话中串行跑多个品类
输入参数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| keyword | string | 必填 | 用户输入的品类入口词，如 "pet water fountain"、"yoga mat" |
| country | string | US | 站点代码，目前支持 US |
| report_lang | string | zh | 报告主体语言（zh / en） |
已挂载能力约束
| skill | 用途 | 调用位置 | 状态 |
|---|---|---|---|
| linkfox-amazon-search | 前台搜索获取商品列表（S1 搜索 3 页 + 降级路径 bestseller 翻页） | S1, S3.2-Fallback | 已挂载 |
| linkfox-sif-asin-keywords | ASIN 流量关键词反查，筛选精准词 | S1 | 已挂载 |
| linkfox-jiimore-get-niche-info-by-keyword | 细分市场洞察（垄断/新品/竞争/趋势） | S2, S3 | 已挂载 |
| linkfox-amazon-category-lookup | 类目节点查询，获取 nodeIdPath | S2 | 已挂载 |
| linkfox-sellersprite-market-statistics | 类目市场统计看板（头部/新品/竞争指标） | S3 | 已挂载 |
| linkfox-aba-intelligent-query | ABA 搜索词趋势与 Top ASIN 点击转化 | S3 | 已挂载 |
| linkfox-google-trend-get-trend-by-keys | Google Trends 关键词 5 年热度趋势 | S3 | 已挂载 |
| linkfox-tsearch-search | 社媒趋势验证（Reddit/TikTok 网络搜索） | S3 | 已挂载 |
| linkfox-amazon-opportunity-report-by-keyword | 亚马逊商业洞察报告（六维分析） | S3 | 已挂载 |
| linkfox-keepa-product-series | Keepa 历史时序数据（价格/BSR/评论/销量） | S6 | 已挂载 |
| linkfox-keepa-product-request | Keepa 商品详情（售价/FBA费/佣金/包装尺寸/类目路径） | S2-A（S6.4-A 缓存复用） | 已挂载 |
| linkfox-sif-asin-summary | SIF ASIN 流量来源构成与曝光分布 | S6 | 已挂载 |
| linkfox-1688-search-by-image | 1688 以图搜图找同款货源 | S6.4-B | 已挂载 |
| linkfox-dld-product-search | 1688 店雷达关键词搜索（工厂货源筛选） | S6.4-B | 已挂载 |
| linkfox-aigc-textgen | AIGC 多模态分析（B1 入参推导 + 货源验证） | S6.4-B | 已挂载 |
| linkfox-report-generator | HTML 报告生成 | S5 | 已挂载 |
执行编排
- 第 1 层（串行）：S1 关键词验证 —— 必须先完成，产出精准关键词和 Top ASIN（销量最高非广告 ASIN）
- 第 2 层（并行）：S2-A 类目节点查询 + S2-B 细分市场发现 —— 两者都依赖 S1 但互不依赖，同一轮并行发起
- 第 3 层（并行 + 条件串行）：S3 数据采集 —— S3.3 复用 S1.1 的 3 页数据不重复搜索；S3.1 极目（复用 S2-B 缓存）/ S3.2 卖家精灵 / S3.3 前台搜索（复用 S1.1）/ S3.4 ABA(2次) / S3.5 Google Trends(5次) / S3.7 商业洞察报告 六路同时发起，互不依赖；S3.6 社媒验证为条件触发步骤，须等 S3.4 + S3.5 均返回后判断触发条件（Google Trends 年度均值增长 ≥50% 或 ABA 排名 26 周内变化 ≥30%），满足则执行三次 tsearch 网络搜索，不满足则跳过。S4 须等 S3.6 完成或确认跳过后才进入
- 第 4 层（串行）：S4 派生计算 —— 依赖 S3 全部返回
- 第 5 层（串行）：S5 报告生成 —— 依赖 S4
- 第 6 层（并行+串行）：S6 Top ASIN 深度拆解 + 利润核算 —— 复用 S1 的 Top ASIN + 3 页搜索数据 + S2-A 的 Keepa 缓存（S6.4-A 不需实际调用）。S6.1 Keepa历史 + S6.2 SIF概览 + S6.3 SIF关键词 三路并行；同时 AIGC 入参推导（读 S2-A 缓存 + S1.1 的 3 页数据 Top 9 商品图）；然后 B1 店雷达 + B2 以图搜图 两路并行；再串行 AIGC 验证（标题预筛选 + 多模态对比）；最后 S6.4-C 净利润核算串行（复用 S2-A Keepa 数据 + S6.4-B 货源数据，含零广告策略判断）
流水线
| 步骤 | 做什么（一句话） | 依赖 | 用途 | 详情 |
|---|---|---|---|---|
| S1 关键词验证 | 前台搜索 3 页一次搜完 → 取销量最高非广告 ASIN（+ S3.3 数据复用）→ SIF 反查筛 isMainKw/isAccurateKw → 得精准词 | 无 | 为 S2/S3/S6 提供精准关键词、Top ASIN 和前台搜索 3 页数据 | references/steps/S1.md |
| S2 类目与细分市场发现 | 并行：S2-A 用 Top ASIN 调 Keepa 获取 categoryTreeId + 商品详情（S6.4-A 缓存复用）+ S2-B jiimore 查 niche 列表并与 SIF 标签词交叉验证 | S1 | 为 S3 提供 nodeIdPath，为 S6.4-A 预取 Keepa 数据 | references/steps/S2.md |
| S3 六源并行采集 | S3.3 复用 S1.1 数据不重复搜索；并行调用极目/卖家精灵统计/ABA(2次)/Google Trends(5次)/社媒验证(条件触发)/商业洞察报告 | S1, S2 | 为 S4 提供全量原始数据 | references/steps/S3.md |
| S4 派生计算 | Python 脚本对四源数据做 CR3/CR5、价格分布、评分分布、产品形态分类等派生统计 | S3 | 为 S5 报告提供所有派生指标 | references/steps/S4.md |
| S5 报告生成 | 按 linkfox-report-generator 规范写 HTML 片段 → 注入模板 → 输出最终报告 | S4 | 交付最终 HTML 报告 | references/steps/S5.md |
| S6 Top ASIN 深度拆解+利润核算 | 复用 S1 的 Top ASIN + 3 页搜索数据 + S2-A 的 Keepa 缓存，三路并行跑 Keepa历史 + SIF概览 + SIF关键词 → AIGC 入参推导 → B1 店雷达 + B2 以图搜图 两路并行 → AIGC 验证 → 串行算净利润（含零广告策略判断） | S1, S2-A, S2-B | 为报告追加头部竞品深度拆解+利润核算章节 | references/steps/S6.md |
报告产物
报告按数据源分节，每个数据源独立做自己的多维度分析，末尾标注 data-source。综合研判章节跨源汇总。结构如下：
报告章节
- 极目细分市场洞察（数据源：jiimore-get-niche-info-by-keyword，多 niche 对比，S2-B 最早获取）
- 搜索量与趋势：每个已验证 niche 的周/季度搜索量、增长率
- 垄断程度：每个 niche 的 Top5 品牌点击份额、Top5 商品点击份额、品牌数、平均品牌年龄
- 新品成功率：每个 niche 的上架数/成功数/成功率
- 竞争指标：每个 niche 的 CPC 三档、ACoS、退货率、毛利率 >50% SKU 占比
- 多 niche 对比表：已验证 niche 间的关键指标横向对比（搜索量、均价、垄断度、新品成功率）
- 亚马逊前台搜索分析（数据源：amazon-search × 3 页，默认相关性排序，S1.1 获取，S3.3 复用）
- 流量聚集度：首页 vs 二页 vs 三页销售额对比，判断首页是否垄断
- 商品集中度：按 position 排序的销量帕累托图 + 累计占比，找到销量剧减拐点
- 品牌集中度：Top 15 品牌销量帕累托图 + 累计占比 + CR3/CR5，判断品牌垄断程度
- 价格分布：按 $0-15/15-30/30-60/60-100/100-200/200+ 分桶，商品数 + 销量占比
- 上架时间分布：按 1月/3月/半年/1年/2年/3年/3年+ 分桶，判断新品冲排名难度
- 上架趋势分布：按上架年份分桶，判断市场迭代速度
- 评分数分布：按 无/1-50/50-100/100-200/200-500/500+ 分桶，判断评论门槛
- 评分值分布：按 <3.0/3.0-3.5/3.5-4.0/4.0-4.2/4.2-4.5/4.5+ 分桶，识别低分高销量竞品
- 卖家类型分布：FBA / AMZ / 其他占比
- 卖家所属地分布：各国商品数 + 销量占比，判断中国卖家竞争强度
- 变体复杂度：有 options 字段的商品占比
- 卖家精灵类目统计（数据源：sellersprite-market-statistics，S3.2 获取）
- 3.1 类目市场规模：总商品数、品牌数、卖家数、月均销量/销售额、年化估算、平均每商品卖家数（竞争密度）、市场上架时间跨度（firstShelfDate→lastShelfDate）、平均重量/体积（物流与仓储成本参考）
- 3.2 头部集中度（对比柱状图：头部 Top10 vs 类目均值）：销量倍数、收入倍数、价格策略对比（头部均价 vs 类目均价）、评分优势对比、评论壁垒对比（头部评论数 + 月增长 vs 均值）、BSR 排名优势量化
- 3.3 新品表现（对比柱状图：新品 vs 类目均值）：新品数量/占比（市场活力）、新品销量 vs 均值（新品是否能达到类目平均水位）、新品收入 vs 均值、新品定价策略（新品均价 vs 类目均价）、新品评分差距、新品评论门槛区间（minNewRatings→maxNewRatings，最低多少条评论能进榜）
- ABA 搜索词分析（数据源：aba-intelligent-query，两次查询）
- 4.1 Part A — 5 关键词搜索排名分析（SIF 标签词 Top 5 的 ABA 排名对比）
- 排名趋势对比折线图（26 周，5 条线，Y 轴反向）
- 排名波动率（变异系数 CV，判断热度稳定性）
- 趋势方向（前半段 vs 后半段均值，改善/恶化百分比）
- 周环比改善/恶化次数
- 最佳/最差排名区间
- 热度梯队分层表（按最新排名分梯队 + SIF 搜索量 + 趋势判断）
- 4.2 Part B — 种子词 Top ASIN 点击转化分析
- Top3 点击集中度 + 转化集中度周趋势（双折线图）
- 最新一周 Top3 ASIN 点击 vs 转化对比柱状图
- 点击-转化效率比（conversionShare ÷ clickShare，识别高转化潜力品）
- 头部 ASIN 更替频率（26 周内 Top1 ASIN 变化次数）
- 4.1 Part A — 5 关键词搜索排名分析（SIF 标签词 Top 5 的 ABA 排名对比）
- Google Trends 关键词热度分析（数据源：google-trend-get-trend-by-keys，5 词 × 5 年）
- 5 年周维度趋势对比折线图（支持 dataZoom 缩放）
- 年度均值对比表（6 年 × 5 词）
- 5 年趋势方向（首年均值 vs 末年均值）
- Google Trends vs ABA 交叉验证表（趋势方向一致性 / 分歧 / 无法对比）
- 社媒趋势验证（条件触发：仅当 Google Trends 出现显著趋势变化时）：搜索 Reddit/TikTok 真实讨论，验证趋势驱动因素（如 TikTok 复古风潮、数字排毒运动等），Quote Cards 展示关键帖子摘要
- 亚马逊商业洞察报告（数据源：amazon-opportunity-report-by-keyword，条件触发）
- 市场潜力：年搜索量、YoY 增长率、近 90 日趋势、销售额、缺货率
- 竞争结构：在售产品数、品牌数变化、Top5 品牌 Click Share、新品上线数
- 产品特征：决胜属性（标配层）+ 溢价属性（差异化层）
- 评价质量：平均评分、差评痛点分布
- 客户画像：买家年龄段、收入区间、使用场景
- 定价分析：价格带分布、甜蜜区、空白价格段
- 跨源交叉验证：洞察报告的 YoY 增长 vs Google Trends 年度均值变化；差评痛点 vs 前台搜索低分高销量竞品；价格甜蜜区 vs 前台搜索价格分布；客户画像 vs 产品形态分类
- Top ASIN 深度拆解（数据源：keepa-product-series + sif-asin-summary + sif-asin-keywords + keepa-product-request + 1688-search-by-image）
- 7.1 Keepa 历史数据解读（Read
references/keepa-interpretation.md获取 8 维度解读规范）：价格波动分析、BSR 排名稳定性、Deal 依赖判断、评论增长趋势、评分波动、月销量趋势、价格-BSR 相关性、生命周期阶段 - 7.2 SIF 流量结构解读（Read
references/sif-asin-interpretation.md获取 8 维度解读规范）：流量来源构成、曝光趋势、关键词覆盖广度、关键词流动性、AC 标签分析、推荐位曝光、变体流量分布、广告投放强度 - 7.3 SIF 关键词反查：Top 10 流量词表（关键词/搜索量/流量份额/自然排名/标签），头部关键词流量集中度
- 7.4 1688 货源匹配与净利润核算：B1 店雷达 + B2 以图搜图两路结果并列展示（不截断 Top N，展示全部通过 AIGC 验证的候选，含匹配/部分匹配标注 + 一句话理由），11 项全量成本拆解表（1688成本/FBA费/佣金/广告费/退货损失/仓储费/入库配置费/头程），净利润与净利润率，零广告策略或市场均值 ACoS 策略标注，成本拆解瀑布图，货源初步筛选提醒（待用户手工确认后重新核算）
- 7.1 Keepa 历史数据解读（Read
- 综合研判（跨源汇总）
- SWOT Grid
- Insight List（行动建议）
报告规则
- 每个数据源章节只分析该数据源返回的字段，不混用其他数据源的数据做同一维度分析
- 每个含统计数字的章节末尾必须标注 data-source（skill 短名）
- 派生计算的章节在 data-source 中追加 .ds-computed 子块，列出指标名与计算方式
- 各数据源之间可能出现同一指标的不同口径值（如 "市场销量"），这属于多角度交叉验证，不是数据冲突
- 降级路径适配：当 sellersprite-market-statistics 返回空数据时，第 3 节「卖家精灵类目统计」自动切换为降级看板（详见 S3.md S3.2-Fallback + S5.md 降级适配），输出三列看板 + 11 维度图表，data-source 标注
amazon-search (bestseller fallback)
报告完整性硬约束（违反即视为报告不合格）
维度零遗漏：上述每个章节中列出的每一个分析维度都必须在报告中出现，禁止以"数据不重要"或"篇幅有限"为由跳过任何维度。若某维度的数据源返回空/失败，必须在报告中保留该维度的标题并注明"数据未获取"（如 SIF 概览返回空时，8.2 的 8 个维度仍需逐一列出标题并标注"数据未获取"）
图表+文字双重输出：每个有图表/表格的维度，必须配一段文字解读（至少 2 句话），说明数据含义和业务洞察。禁止只放图表/表格不写解读——图表展示"是什么"，文字解读"意味着什么"
指标全量展示：要求中列出的每个指标都必须展示。例如第1章要求"CPC 三档、ACoS、退货率、毛利率>50% SKU 占比"，则在 niche 对比表或独立表格中必须包含这 4 个指标列，不可只展示部分
数据缺失的处理规范：
- 数据源返回空/失败时：保留章节标题 + 注明"数据未获取" + 说明原因（如"5个精准词全部返回4004"）
- 降级路径下不可算的字段：标注"数据未提供"（如 sellers/avgSellers/avgProfit 等）
- 条件触发步骤未触发时：注明触发条件及判断结果（如"Google Trends 年度增长 <50%，未触发社媒验证"）
- 禁止静默跳过：任何章节/维度缺失都必须在报告中有显式说明，不能直接消失
章节编号对齐：报告中的章节编号和标题必须与上述要求一一对应。例如要求中"2.6 销量天花板"，报告中必须用相同或包含"销量天花板"的标题，不可改用其他名称导致对应关系丢失
如果需要生成报告 / 精美报告，必须去阅读 SKILL
linkfox-report-generator，根据它的规范来。 本 skill 只负责把业务数据准备好；样式、排版、md/html 导出、元信息块统统由linkfox-report-generator负责。 不要在此处复制报告样式或 html 模板。
执行自检
每次跑完流程，agent 在收尾时确认：
- S1 成功获取精准关键词（isMainKw/isAccurateKw 标签验证通过）
- S2 成功获取 nodeIdPath 和 nicheTitle 列表
- S3 四个数据源全部返回非空数据（errcode=200）
- S3.6 社媒验证已检查触发条件：若 Google Trends 年度均值增长≥50%或ABA排名变化≥30%，确认已执行 tsearch 搜索（脚本路径
linkfox-tsearch-search/scripts/tsearch_web_search.py，参数仅keyword字段） - S3.7 商业洞察报告已尝试重试：首个关键词返回 4004 时，依次尝试 SIF 精准词 Top 5（脚本调用须加
--inline标志） - S4 派生计算 JSON 包含报告所需全部指标
- S5 报告 HTML 成功落盘，路径已告知用户
- Section 3（卖家精灵类目统计）使用了
sellersprite-dashboard.md模板的三列看板布局 - S6.4 利润核算已完成：S6.4-A Keepa详情获取了 fbaFees/referralFeePercentage/包装尺寸；S6.4-B 1688匹配到至少1个供应商；S6.4-C 11项成本全部计算并输出净利润
- S6.4-B AIGC 入参推导已完成：从 S1.1 的 3 页数据 Top 9 非广告商品 + 目标 ASIN 主图调用 AIGC，产出 keyWord + beginPrice/endPrice
- S6.4-B AIGC 验证已完成：B1+B2 结果经标题预筛选 + AIGC 多模态验证，保留匹配和部分匹配的候选
- S6.4-C 零广告策略已判断：S6.2 sponsoredProductsKeywordCount=0 时广告费=$0，否则用 nicheTACoS（回退 adTACoS）
- S6.4-B 结果分别展示：B1 和 B2 结果并列展示，不自动合并，由用户决策
- 报告每个章节都有 data-source 标注
- 如果某个数据源调用失败，在报告对应章节注明"数据未获取"
已知局限
- 目前仅支持美国站（US），其他站点需等待各 Tier 1 skill 扩展支持
- SIF 反查的 isMainKw/isAccurateKw 标签依赖于 SIF 数据更新周期，可能存在延迟
- jiimore 查询词如果过于长尾可能返回空结果，需要按搜索量降序依次重试
- amazon-category-lookup 的类目匹配基于名称模糊搜索，可能需要人工确认最匹配的节点
- ABA 数据为周维度，非日维度；排名越小热度越高
- 前台搜索 3 页约返回 150 个商品（默认相关性排序），不代表全量市场，仅反映该关键词下的竞争格局；降级路径下动态翻页直到 100 个非广告商品（bestseller 排序）
- 各数据源统计口径不同（如销量估算算法不同），同一指标可能出现不同数值，属正常交叉验证现象