linkfox-amazon-opportunity-screener

按指标筛选 Amazon 机会

此技能将指导你如何根据从历史机会报告中汇总的指标池，反向搜索 Amazon 利基市场和关键词，帮助卖家将模糊的选品想法（低竞争、需求增长、蓝海、痛点机会等）转化为具体的利基市场候选项。

核心概念

此工具提供一个可查询的利基市场级指标池（每条记录约有 37 个字段），这些指标从以往的 Amazon 机会报告中提炼而来。它不是生成一份新报告（正向分析），而是让你按 30 多个业务维度对现有指标池进行反向筛选，并返回按采集时间排序（最新优先）的 (marketplace, keyword) 记录。

记录的粒度为利基市场／关键词，而非 ASIN。每条记录代表一个利基市场快照，涵盖其市场规模、增长、竞争、价格区间、人口特征、热门特征和评论主题。

正向分析与反向筛选：当用户提供关键词并希望获取全面的 AI 报告时，使用 linkfox-amazon-opportunity-report。当用户提供业务筛选条件，并希望发现符合条件的关键词／利基市场时，使用此技能。

筛选维度

筛选条件分为六个业务维度。所有筛选参数均为可选，但必须至少提供 keyword／nicheName 或任意指标筛选条件——完全为空的调用将被拒绝。

维度	参数示例	用户的典型意图
市场规模与增长	nicheRevenue360dMinUsdAtLeastGte、nichePeakSearchVolumeAtLeastGte、nicheSearchVolumeYoyChangePctAtLeastGte、nichePeakMonthGte/Lte	“市场规模足够大”、“快速增长”、“第 4 季度季节性市场”
竞争密度	nicheBrandCountLte、nicheBrandCountYoyChangePctAtLeastLte、nicheTop5ProductClickSharePctAtLeastLte、featureTop5BrandSharePctAtLeastLte	“对新手友好”、“品牌分散”、“没有寡头垄断”、“品牌正在退出”
价格与档次	priceMinUsdGte、priceMaxUsdLte、priceSweetSpotMinUsdGte/Lte、priceEntryClickSharePctAtLeastGte、priceMidClickSharePctAtLeastLte、priceHighClickSharePctAtLeastGte	“聚焦平价产品”、“适合高端产品”、“中档蓝海市场”
人口特征	demoPrimaryAgeMinGte、demoPrimaryAgeMaxLte、demoGenderDominant、demoPrimaryIncomeTier、demoLifeStageTagsContains	“女性主导”、“高收入人群”、“父母”、“健身爱好者”
产品特征	featureNewAvgReviewCountAtLeastLte、featureEstablishedAvgReviewCountAtLeastLte、featureEmergingTrendTagsContains、featureUncommonFeatureTagsContains、searchTopCategory1Label	“新产品进入门槛低”、“新兴趋势”、“独特功能优势”、“套装／组合产品利基市场”
评论洞察	reviewPositiveTop1Topic、reviewPositiveTop1PctAtLeastGte/Lte、reviewNegativeTop1Topic、reviewNegativeTop1PctAtLeastGte/Lte、reviewNegativeTop2Topic、reviewStrategicInsightTagsContains	“痛点利基市场”、“注重舒适度的卖家”、“尺寸问题带来的机会”

完整参数列表、类型、取值范围和响应字段映射请参见 references/api.md。

支持的站点

目前仅支持美国（US）。请始终将 amazonDomain 设为 US（也可以省略）。如果用户请求其他站点，请告知他们此工具目前仅覆盖美国市场。

API 使用方法

此工具会调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参见 references/api.md。你也可以直接运行 scripts/amazon_opportunity_screener.py 来执行查询。

如何构建查询

用户用自然语言表达业务意图；你需要将其映射为数量最少且可行的一组筛选条件。原则：

1. 将意图转化为具体边界：“竞争低” → nicheBrandCountLte: 20；“快速增长” → nicheSearchVolumeYoyChangePctAtLeastGte: 100（同比增长 ≥100%）；“适合新手” → featureNewAvgReviewCountAtLeastLte: 500。
2. 先缩小范围，再放宽条件：首次调用通常使用 2–4 个强筛选条件，并设置 limit=25。如果结果集为空或过小，应删除或放宽最严格的筛选条件，而不是添加新条件。
3. 组合互补信号：品牌层级与产品层级的集中度（featureTop5BrandSharePctAtLeastLte + nicheTop5ProductClickSharePctAtLeastGte）可以揭示“品牌分散但产品集中”的情况——这是品牌扩展的切入信号。
4. 标签字段使用 snake_case 片段：featureEmergingTrendTagsContains、demoLifeStageTagsContains、reviewNegativeTop1Topic 等接受 snake_case 单词片段，并使用 LIKE 匹配。传入词根（size、parent、cordless）即可涵盖标准化后的变体。
5. 忠实于用户意图：不要擅自添加用户未要求的筛选条件。如果用户只说“增长”，就只筛选增长情况；除非用户提到价格，否则不要额外限制价格。

常见场景

1. 根据关键词反向查找利基市场

{"keyword": "whoop band", "limit": 25}

2. 适合新手、竞争低的利基市场

{"nicheBrandCountLte": 20, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}

3. 高增长蓝海市场（同比增长 ≥100%，品牌尚未大量涌入）

{"nicheSearchVolumeYoyChangePctAtLeastGte": 100, "nicheBrandCountYoyChangePctAtLeastLte": 30, "limit": 25}

4. 中端价格空缺（低价产品占主导，中端产品稀缺）

{"priceEntryClickSharePctAtLeastGte": 70, "priceMidClickSharePctAtLeastLte": 5, "limit": 25}

5. 从痛点切入——尺寸投诉突出

{"reviewNegativeTop1Topic": "size", "reviewNegativeTop1PctAtLeastGte": 70, "limit": 25}

6. 适合高端产品、女性驱动的利基市场

{"demoGenderDominant": "female", "demoPrimaryIncomeTier": "high", "priceHighClickSharePctAtLeastGte": 25, "limit": 25}

7. 旺季搜索峰值 ≥10 万的 Q4 季节性利基市场

{"nichePeakMonthGte": 11, "nichePeakMonthLte": 12, "nichePeakSearchVolumeAtLeastGte": 100000, "limit": 25}

8. 跟踪围绕已知竞品品牌的利基市场

{"featureTopBrandsContains": "WHOOP", "limit": 50}

展示规则

1. 仅呈现数据：将返回的利基市场整理为清晰的对比表格——利基市场名称 / 关键词、市场规模、增长、品牌数量、价格范围、关键标签。不要提供主观的商业建议。
2. 显示当前使用的筛选条件：回显所用筛选条件，方便用户调整（“当前筛选：品牌数 ≤ 20 且搜索量同比 ≥ 100%”）。
3. 提醒数据快照时间：记录反映的是数据采集时的情况，并非持续更新。当结果看起来过时或与用户掌握的外部信息矛盾时，请说明这一点。
4. 处理结果为空或过少的情况：如果 data 为空或结果很少，建议放宽最严格的筛选条件，而不是让用户从头重新描述需求。
5. 错误处理：查询失败时，根据 msg 字段说明原因（最常见的是“参数完全为空”保护机制），并建议至少添加一个筛选条件。
6. 不进行二次聚合：这些结果用于前端展示且不会被存储，因此无法传入 @智能数据查询（智能数据查询）进行进一步聚合。如果用户需要跨多个利基市场的分组统计，请在本地计算，或先调高 limit 获取更多结果。

重要限制

• 仅支持美国：目前仅支持美国站点（amazonDomain = US）。
• 不支持分页：没有 page 参数。增大 limit（最大 200）以扩大候选范围；结果按采集时间排序，最新的排在前面。
• 至少需要一个筛选条件：既未提供 keyword / nicheName，又未提供指标筛选条件的调用会被拒绝。
• 快照数据：记录汇总自历史商机报告；新报告会随时间更新候选范围，但单条记录并非实时数据。
• 利基市场级粒度：输出粒度为利基市场 / 关键词级别，而非 ASIN 级别。若要深入查看某个利基市场中的具体产品，请转交给 linkfox-amazon-search、linkfox-keepa-product-search 等工具。

用户表达与场景速查

适用 — 美国亚马逊市场的细分市场反向筛选：

用户表达	场景
“竞争较小的细分市场”、“适合新手”、“品牌较少”	品牌密度筛选
“品牌正在退出”、“老玩家正在撤退”	品牌数量同比下降
“快速增长的细分市场”、“呈上升趋势”、“同比 ≥100%”	搜索量同比筛选
“中端蓝海”、“低价占主导，但中端产品稀缺”	价格层级份额差距
“适合高端产品”、“高收入消费者”	收入层级 + 高端份额
“女性 / 男性 / 混合市场”	性别主导度筛选
“父母 / 学生 / 退休人士 / 健身爱好者”	人生阶段标签
“尺寸 / 质量 / 耐用性问题突出”	负面评价主题 + 占比
“以舒适为驱动”、“以价值为驱动的卖家”	正面评价主题 + 占比
“跟踪品牌 X 周边的所有细分市场”	featureTopBrandsContains
“Q4 季节性细分市场”、“Prime Day 时段”	峰值月份 + 峰值销量

不适用 — 请改用其他工具：

• 需要针对一个关键词生成全面的 AI 报告 → linkfox-amazon-opportunity-report
• ASIN 级竞品研究、销量估算 → SellerSprite / Keepa / Sorftime 工具
• 实时关键词排名、搜索词挖掘 → ABA / SIF 工具
• 美国以外的市场 → 此工具尚不支持
• 想通过 @智能数据查询 对细分市场运行分组聚合 → 不支持（数据未存入数据仓库）

适用边界：当用户用业务语言描述筛选条件，并希望找到符合条件的候选细分市场时，适用此技能。当用户提供具体关键词并希望进行多维度全面分析时，请使用 linkfox-amazon-opportunity-report。当用户希望深入了解某个细分市场内的 ASIN / 卖家时，请转交给商品搜索工具。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户对这项技能表示不满或赞扬
4. 任何你认为可以改进的地方

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/amazon_opportunity_screener.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。保存的响应可能包含个人身份信息、定价或身份验证敏感数据——请勿提交。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览 + 文件路径。read 可筛选指定字段，并通过 --limit/--offset 进行切片，通过 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况 — 请根据响应特征自行判断，例如：

• 每条记录的字段较多，或包含不需要的字段
• 批量 / 分页结果（每次调用返回多个项目）
• 长文本字段（描述、评价、HTML、时间序列）
• 后续步骤需要重复使用输出，而非立即消费

对于较小的一次性响应，直接调用主脚本即可。

⚠️ 预览是经过截断的架构 + 样例，并非完整数据。任何字段级决策都必须通过 read 从已保存的文件中读取。

---

如需了解更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。