用途
该技能用于通过 Sorftime 数据在亚马逊平台上进行多维度产品搜索与筛选，帮助卖家发现产品、分析竞品、探索市场机会。当用户提出 Sorftime 产品搜索、亚马逊产品筛选、竞品调研、类目分析、品牌热销、卖家分析、季节性产品、历史快照回看、月销量月销额、ABA 关键词找产品、价格范围筛选、新品发现、多条件组合筛选等需求时适用。
该工具的核心定位是跨产品搜索与筛选。如果需要某个具体 ASIN 的详细趋势数据（销量/价格/BSR 历史），应改用 Sorftime Product Detail 技能。
主要能力
支持 16 种查询类型，可单选或通过 AND 逻辑组合：
- queryType=1：ASIN 相似（注意是找相似产品，不是该 ASIN 本身）
- queryType=2：类目（NodeId）
- queryType=3：品牌
- queryType=4：卖家名称
- queryType=5：卖家 ID
- queryType=6：ABA 关键词
- queryType=7：标题/属性匹配
- queryType=8：价格区间（单位为分，$19.99 = 1999）
- queryType=9：月销量区间
- queryType=10：季节性产品（月份列表）
- queryType=11：上架日期区间
- queryType=12：评分区间
- queryType=13：评论数区间
- queryType=14：排名区间（BSR / 子类目）
- queryType=15：配送方式（FBA / FBM）
- queryType=16：变体数区间
返回数据字段包括：基础信息（ASIN、标题、品牌、Listing URL、图片、父 ASIN、变体数、重量、尺寸）；价格与利润（当前价、券后价、划线价、优惠券、FBA 费用及明细、平台费、利润额与利润率）；销量（月销量、月销额、日销量、日销额，-1 表示无法估算）；排名（BSR 排名、类目、子类目排名）；评分（评分值、评论数）；Listing 信息（上架日期、在线天数）；卖家（Buybox 卖家名称/ID/国家、FBA 状态、卖家数）；Listing 特征（A+ 内容、视频、品牌店铺）。
支持站点
美国（us）、英国（gb）、德国（de）、法国（fr）、印度（in）、加拿大（ca）、日本（jp）、西班牙（es）、意大利（it）、墨西哥（mx）、阿联酋（ae）、澳大利亚（au）、巴西（br）、沙特阿拉伯（sa）。默认站点为美国；站点代码使用小写，英国编码为 gb（不是 uk）。
使用方式
API 端点：POST /sorftime/amazon/productQuery（完整参数/响应/错误码见 references/api.md）。
Python 脚本：python scripts/sorftime_product_search.py '<JSON 参数>' [--inline]
关键参数为 marketplace（必填）、queryMode、queryType、queryValue。queryMode=1 用于单一筛选；queryMode=2 用于多条件 AND 组合。价格区间使用分单位，可使用开区间（如 ,1000 表示不超过 1000；100, 表示 100 及以上）。queryMonth（格式 yyyy-MM）用于查询历史月度快照。
成本约束：本工具消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-amazon-product-query-<timestamp>.json；响应体 ≤ 8 KB 时落盘后打印完整 JSON 到 stdout；> 8 KB 时落盘后仅输出摘要；加 --inline 强制全量打印（同样落盘）。读数据建议先看摘要，再按需从保存的 json 文件抽取字段。
认证与算力问题：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401 或 402、提示算力或余额不足（如算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值）时，按 references/onboarding.md 引导解决。
历史快照
设置 queryMonth（格式 yyyy-MM）可查询过去某月的产品数据快照。支持范围为 2024 年 1 月至今（约 2 年）。美国、英国、德国支持完整“无限制”回看模式；其他站点回看仅支持 Top 100 产品；澳大利亚、巴西、印度不支持回看。
展示规则
仅呈现数据：以清晰表格展示查询结果，不提供主观商业建议。排名说明：展示排名数据时提醒用户数值越小排名越好。分页提示：搜索结果每页最多 100 个产品，最多 200 页；结果较多时应展示要点并提醒用户分页。销量估算说明：销量/销额字段为 -1 表示“无法估算”，应向用户解释而非直接展示 -1。错误处理：查询失败时依据 msg 字段解释原因，并建议调整查询条件。
限制
- 分页：每页最多 100 个产品，最多 200 页
- 非结构化数据：结果不支持通过 _dataQuery_executeDynamicQuery 进行二次分析
- 销量估算：非标准类目的产品销量字段可能返回 -1
- ABA 关键词搜索（queryType=6）：当前仅支持 ABA 关键词，不支持任意搜索词
算力消耗规则
按动态规则计费：消耗算力 = Sorftime 内部查询次数 × 6。内部查询次数由 Sorftime 决定，不同查询条件可能不同。本技能按倍数动态计算，可能一次性消耗大量算力，必须提醒用户并由用户决定是否继续。
适用场景
适用于亚马逊产品搜索与筛选场景，例如：找某类目下热销产品（类目探索）、某品牌热销产品（品牌分析）、某 ASIN 的竞品（竞品发现）、寻找季节性产品、筛选新品中月销量超过 500 的产品、历史快照对比、某卖家的在售产品组合、筛选利润率高于 30% 的 FBA 产品、月销量 1000 以上且评分 4 星以上的产品、标题包含特定关键词的产品等。
不适用场景
不适用于：某个具体 ASIN 的详细趋势/历史数据（改用 Sorftime Product Detail）；ABA 搜索词排名数据（改用 ABA Data Explorer）；广告/PPC 策略；产品评论内容分析；专利或商标查询。
边界判断：当用户说“竞品分析”或“市场调研”时，若需要跨维度（类目、品牌、价格区间等）发现并对比产品，则适用本技能；若需要某个具体 ASIN 的历史趋势曲线，应使用产品详情技能；若需要关键词搜索量数据，应使用 ABA Data Explorer。
附：常见查询示例
- 某 ASIN 的竞品：queryMode=1, queryType=1, queryValue=B0CVM8TXHP, marketplace=us
- 浏览某类目热销：queryMode=1, queryType=2, queryValue=3743561, marketplace=us
- 分析某品牌产品组合：queryMode=1, queryType=3, queryValue=Anker, marketplace=us
- 按 ABA 关键词搜索：queryMode=1, queryType=6, queryValue=Power Bank, marketplace=us
- 发现季节性产品（Q4 峰值）：queryMode=1, queryType=10, queryValue=10,11,12, marketplace=us
- 历史与当前对比：queryMonth=2024-11, queryMode=1, queryType=2, queryValue=3743561, marketplace=us，再与不带 queryMonth 的当前数据对比
- 多条件：新品且高销量且 FBA：queryMode=2, queryValue=[{"QueryType":11,"Content":"2024-06-01,"},{"QueryType":9,"Content":"300,"},{"QueryType":15,"Content":"FBA"}], marketplace=us
- 低价高销量：queryMode=2, queryValue=[{"QueryType":8,"Content":",2000"},{"QueryType":9,"Content":"500,"}], marketplace=us
- 查看某卖家产品组合：queryMode=1, queryType=4, queryValue=AnkerDirect, marketplace=us
反馈
当技能描述的功能或用途与实际行为不符、结果与用户意图不符、用户表达不满或赞扬、或存在可改进之处时，应通过 Feedback API 自动检测并上报反馈，不打断用户操作流程。