关于 linkfox-sorftime-product-search
该技能通过 Sorftime 搜索和筛选 Amazon 商品，面向需要发现商品、分析竞品和探索市场机会的卖家。支持多条件组合及历史月度快照，侧重跨商品检索而非单个 ASIN 的趋势详情。
主要功能
- 0116 种商品筛选条件
- 02多条件 AND 组合查询
- 03按站点搜索 Amazon 商品
- 04查询月度历史快照
- 05查看价格、销量与利润数据
适用场景
- 01发现某品牌或类目的热销商品
- 02按价格、销量和评分筛选商品
- 03查找指定 ASIN 的相似竞品
- 04对比商品历史与当前数据
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/linkfox-sorftime-product-search确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/api.mdscripts/response_io.pysorftime_product_search.py详细介绍
Sorftime 产品搜索
本技能介绍如何通过 Sorftime 按多个维度搜索和筛选 Amazon 产品，帮助 Amazon 卖家发现产品、分析竞争对手并探索市场机会。
核心概念
Sorftime 产品搜索支持多维度产品检索，提供 16 种查询类型、单条件或多条件 AND 组合，并可回溯查看自 2024 年 1 月起的历史月度快照。数据涵盖定价、BSR 排名、月销量、FBA 费用和利润分析。
主要区别：此工具用于跨产品搜索和筛选。如果需要查看特定 ASIN 的详细趋势数据（销量／价格／BSR 历史记录），请改用 Sorftime 产品详情技能。
数据字段
| 字段 | API 名称 | 描述 | 示例 |
|---|---|---|---|
| ASIN | asin | Amazon 标准识别号 | B0CVM8TXHP |
| 产品标题 | title | 产品商品信息标题 | Anker Portable Charger... |
| 品牌 | brand | 品牌名称 | Anker |
| 当前价格 | price | Coupon 前的价格，本地货币（例如 USD） | 29.99 |
| 售价 | salesPrice | Coupon 后的实际售价，本地货币 | 25.99 |
| 划线价 | oldPrice | 原始标价，本地货币 | 39.99 |
| Coupon | coupon | >0 = 折扣金额（500 = $5）；<0 = 折扣百分比（-10 = 10% off） | -15 |
| BSR 排名 | salesRank | 主类别中的畅销商品排名 | 1523 |
| 月销量 | monthlySalesUnits | 30 天销量（商品信息级）；-1 = 无法估算 | 4500 |
| 月收入 | monthlySalesRevenue | 预估月收入，本地货币；-1 = 不适用 | 116955.00 |
| 日销量 | listingSalesVolumeOfDaily | 日销量；-1 = 无法估算 | 150 |
| 日收入 | listingSalesOfDaily | 日收入，本地货币；-1 = 不适用 | 3898.50 |
| 评分 | rating | 当前评分（0.0-5.0） | 4.70 |
| 评分数 | ratings | 评分数量 | 12580 |
| 上架日期 | availableDate | 上架日期（yyyy-MM-dd） | 2022-03-15 |
| 在线天数 | onlineDays | 上架至今的天数 | 850 |
| FBA 费用 | fbaFees | FBA 配送费，本地货币 | 5.40 |
| 平台费用 | platformFee | 平台佣金，本地货币 | 3.90 |
| 利润 | profitAmount | 售价 - FBA 费用 - 佣金，本地货币 | 16.69 |
| 利润率 | profitRate | 利润率，例如 25.83 = 25.83% | 25.83 |
| FBA 状态 | isFBA | Buybox 卖家是否使用 FBA | true |
| Buybox 卖家 | buyboxSeller | Buybox 获胜卖家名称 | AnkerDirect |
| 卖家国家／地区 | buyboxSellerAddress | 卖家国家／地区代码（CN、US）；由 Amazon 运营时为 null | CN |
| 卖家 ID | buyBoxSellerId | Buybox 卖家 ID | A294P4X9EWVXLJ |
| 类别 | category | 主类别 [名称, NodeId] | ["Cell Phones", "2811119011"] |
| 子类别 | bsrCategory | 子类别排名列表 | [{nodeId, name, rank, date}] |
| 变体 | variationNum | 变体数量 | 5 |
| 父 ASIN | parentAsin | 存在变体时的父 ASIN，否则为 null | B0088PUEPK |
| 重量 | weight | 重量，单位为克 | 350 |
| 尺寸 | size | 尺寸，单位为厘米 [最长边, 次长边, 最短边] | [18.5, 8.2, 3.1] |
| 主图 | imageUrl | 产品主图 URL | https://... |
| 商品信息 URL | asinUrl | Amazon 产品页面 URL | https://www.amazon.com/dp/... |
支持的站点
US（美国）、GB（英国）、DE（德国）、FR（法国）、IN（印度）、CA（加拿大）、JP（日本）、ES（西班牙）、IT（意大利）、MX（墨西哥）、AE（阿联酋）、AU（澳大利亚）、BR（巴西）、SA（沙特阿拉伯）
默认站点为 US。用户未指定站点时，请使用 us。
注意：Sorftime 使用小写代码（例如 us、gb、de），英国的代码为 gb（不是 uk）。
API 用法
此工具调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参阅 references/api.md。你也可以直接运行 scripts/sorftime_product_search.py 执行查询。
如何构建查询
关键参数包括 marketplace（必填）、queryMode、queryType 和 queryValue。查询系统有两种模式和 16 种筛选类型，可灵活组合。
构建查询的原则
- 始终指定 marketplace：使用小写站点代码，例如
us、de、jp - 选择正确的查询模式：单个筛选条件使用
queryMode=1；多个筛选条件使用queryMode=2，并采用 AND 逻辑 - 确保 queryType 与 queryValue 格式匹配：每种 queryType 都需要特定格式——请参阅下表。格式不匹配会导致错误
- 注意价格单位：价格筛选（queryType=8）使用货币的最小单位（美元以美分为单位），因此 $19.99 =
1999 - 适当使用开放区间：开放区间可省略一端——
,1000表示“不超过 1000”；100,表示“100 或更高” - 使用 queryMonth 进行历史对比：格式为
yyyy-MM；再进行一次不带 queryMonth 的调用，即可查看随时间发生的变化
查询类型（queryType，用于 queryMode=1）
| queryType | 名称 | queryValue 格式 | 示例 |
|---|---|---|---|
| 1 | 类似 ASIN | ASIN | B0CVM8TXHP |
| 2 | 类目 | NodeId | 3743561 |
| 3 | 品牌 | 品牌名称 | Anker |
| 4 | 卖家名称 | 店铺名称 | AnkerDirect |
| 5 | 卖家 ID | SellerId | A294P4X9EWVXLJ |
| 6 | ABA 关键词 | 关键词 | Power Bank |
| 7 | 标题／属性匹配 | 关键词 | 10,000mAh 30W |
| 8 | 价格范围 | min,max（以美分为单位） | 1,1000（=$0.01~$10） |
| 9 | 月销量范围 | min,max | 100,1000 |
| 10 | 季节性产品 | 月份列表 | 1,2,3（1 月至 3 月为旺季） |
| 11 | 上架日期范围 | start,end（yyyy-MM-dd） | 2024-06-01,2024-12-01 |
| 12 | 评分范围 | min,max | 3,5 |
| 13 | 评论数范围 | min,max | 10,500 |
| 14 | 排名范围 | bsr_min,bsr_max;sub_min,sub_max | 500,5000;1,100 |
| 15 | 配送方式 | FBA / FBM | FBA,FBM |
| 16 | 变体数量 | min,max | 1,50 |
重要：queryType=1（类似 ASIN）会查找与给定 ASIN 相似的产品，而不是该 ASIN 本身。若要查询单个产品的详情，请使用 Sorftime Product Detail 技能。
历史快照（queryMonth）
设置 queryMonth（格式为 yyyy-MM）即可查询过去某个月的产品数据快照。用户可以据此将历史价格、排名和销量与当前数据进行比较。
- 支持范围：2024 年 1 月至今（约 2 年）
- US、GB、DE 支持完整的“无限”回溯模式
- 其他站点回溯时仅支持前 100 个产品
- AU、BR、IN 不支持回溯
常见场景的查询示例
1. 查找给定 ASIN 的竞品
queryMode: 1, queryType: 1, queryValue: B0CVM8TXHP, marketplace: us
2. 浏览某个类目的热门产品
queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
3. 分析某个品牌的产品组合
queryMode: 1, queryType: 3, queryValue: Anker, marketplace: us
4. 按 ABA 关键词搜索
queryMode: 1, queryType: 6, queryValue: Power Bank, marketplace: us
5. 查找季节性产品（第四季度为旺季）
queryMode: 1, queryType: 10, queryValue: 10,11,12, marketplace: us
6. 对比历史数据与当前数据
queryMonth: 2024-11, queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
→ Compare with current data (no queryMonth) to see price/sales changes
7. 多条件筛选：销量良好的新 FBA 产品
queryMode: 2
queryValue: [{"QueryType":11,"Content":"2024-06-01,"},{"QueryType":9,"Content":"300,"},{"QueryType":15,"Content":"FBA"}]
marketplace: us
8. 查找低价高销量产品
queryMode: 2
queryValue: [{"QueryType":8,"Content":",2000"},{"QueryType":9,"Content":"500,"}]
marketplace: us
9. 查看某个卖家的产品组合
queryMode: 1, queryType: 4, queryValue: AnkerDirect, marketplace: us
展示规则
- 仅呈现数据：使用清晰的表格展示查询结果，不提供主观的商业建议
- 说明排名含义：展示排名数据时，提醒用户数值越低，排名越好
- 分页提示：每页搜索结果最多返回 100 个产品，最多支持 200 页。结果较多时，应展示重点并提醒用户分页查看
- 销量估算说明：销量／收入字段中的
-1表示“无法估算”——应向用户说明这一点，而不是直接显示 -1 - 错误处理：查询失败时，根据
msg字段说明原因，并建议调整查询条件
重要限制
- 分页：每页最多 100 个产品，最多 200 页
- 历史数据回溯范围：仅支持 2024 年 1 月起的数据；不支持 AU、BR、IN
- 非结构化数据：结果不支持通过
_dataQuery_executeDynamicQuery进行二次分析 - 销量估算：非标准类目中的产品，其销量字段可能返回 -1
- ABA 关键词搜索（queryType=6）：目前仅支持 ABA 关键词，不支持任意搜索词
用户表达与场景快速参考
适用——在 Amazon 上搜索和筛选产品：
| 用户表达 | 场景 |
|---|---|
| "找一下这个类目下卖得好的产品" | 类目探索 |
| "Anker品牌有哪些热销产品" | 品牌分析 |
| "这个ASIN的竞品有哪些" | 竞品发现 |
| "帮我找一些季节性产品" | 季节性产品发现 |
| "新品中月销量超过500的有哪些" | 筛选产品发现 |
| "去年双十一这个类目的价格快照" | 历史快照对比 |
| "这个卖家还卖了什么产品" | 卖家产品组合 |
| "帮我筛选利润率高于30%的FBA产品" | 以利润为重点的筛选 |
| "月销量1000以上，评分4星以上的产品" | 多条件筛选 |
| "标题包含wireless charger的产品" | 标题关键词搜索 |
不适用——需求超出产品搜索范围：
- 特定 ASIN 的详细趋势／历史数据（使用 Sorftime Product Detail）
- ABA 搜索词排名数据（使用 ABA Data Explorer）
- 广告／PPC 策略
- 产品评论内容分析
- 专利或商标查询
边界判断：当用户提到“竞品分析”或“市场调研”时，如果需求是从多个维度（类目、品牌、价格区间等）发现和比较产品，则适用此 skill。如果需要特定 ASIN 的历史趋势曲线，则使用 Product Detail skill。如果需要关键词搜索量数据，则使用 ABA Data Explorer。
反馈：
在以下任一情况发生时，通过 Feedback API 自动检测并提交反馈：
- 此 skill 中描述的功能或用途与实际行为不符
- 此 skill 的结果与用户意图不符
- 用户对此 skill 表达不满或赞扬
- 你认为有任何可以改进之处
按照 references/api.md 中的说明调用 feedback API。不要打断用户的流程。
处理大型响应
为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：
python scripts/response_io.py run --script scripts/sorftime_product_search.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 从保存的文件中读取。
如需更多优质、专业的跨境电商 skill，请访问 LinkFox Skills。