linkfox-sorftime-amazon-product-query

name	linkfox-sorftime-amazon-product-query
description	基于Sorftime数据的亚马逊多维度产品搜索与筛选，涵盖14个站点，支持历史月份快照回看。当用户提到Sorftime产品搜索、亚马逊产品筛选、竞品调研、类目分析、品牌热销、卖家分析、季节性产品、历史快照回看、产品搜索、月销量月销额、ABA关键词找产品、价格范围筛选、新品发现、多条件组合筛选、product search, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot时触发此技能。即使用户未明确提及\"Sorftime\"，只要其需求涉及亚马逊产品搜索、筛选、对比或类目/品牌/卖家维度的产品探索，也应触发此技能。

Sorftime-亚马逊产品搜索

基本信息

• 业务工具名：/sorftime/amazon/productQuery
• 所属分组：Sorftime · 亚马逊选品
• 功能说明：支持多样化检索，基于 ASIN 找同类产品、类目/品牌/卖家追踪、ABA 关键词调研，以及标题/属性关键词匹配。数据涵盖：价格信息（原价、实际售价及 Coupon 政策）、BSR 排名趋势（支持大类及各细分小类排名追踪）、以及历史月度销量与销额。此外，该工具还提供 FBA 配送费/仓储费明细、平台佣金、产品毛利及毛利率，为定价策略调整、利润空间测算及库存计划提供核心数据支撑。
• 关键词：Sorftime, 产品筛选, 竞品调研, 类目分析, 历史快照,利润分析,FBA费用分析

何时使用

当用户意图与“Sorftime-亚马逊产品搜索”匹配，或需要以下能力时使用本工具：支持多样化检索，基于 ASIN 找同类产品、类目/品牌/卖家追踪、ABA 关键词调研，以及标题/属性关键词匹配。数据涵盖：价格信息（原价、实际售价及 Coupon 政策）、BSR 排名趋势（支持大类及各细分小类排名追踪）、以及历史月度销量与销额。此外，该工具还提供 FBA 配送费/仓储费明细、平台佣金、产品毛利及毛利率，为定价策略调整、利润空间测算及库存计划提供核心数据支撑。

调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。

输入参数

字段	类型	必填	约束/默认值	说明
page	integer	否	默认 1；最小 1	分页页码.每页最多100个产品，默认1
queryMode	integer	否	默认 1；示例：1, 2	查询方式.1：单条件查询（默认）；2：多条件组合查询（且关系）
queryType	integer	否	示例：1, 2, 3, 4, 5, 6, 7, 8	查询类型（仅当query=1时生效，query=2时此参数无效）。1:基于ASIN查询同类产品（注意：并非只查该ASIN，查单个产品请用productDetail接口）；2:基于类目(NodeId)查询；3:查询品牌热销产品；4:基于卖家名称查询热销产品；5:基于卖家SellerId查询热销产品；6:基于ABA关键词查热销产品（暂仅支持ABA关键词）；7:基于产品标题或产品属性包含词查产品；8:限定销售价范围查产品，单位为当地货币最小单位（如美分，1999表示$19.99）；9:限定月销量(近30日)范围查产品；10:限定季节性产品，仅返回所查月份的季节性产品；11:限定上架时间范围查产品，日期格式yyyy-MM-dd；12:限定星级范围查产品；13:限定评论数量范围查产品；14:限定排名范围查产品（需组合大小类排名）；15:限定发货方式查产品；16:限定子体数范围查产品
queryMonth	string	否	格式 ^\d{4}-\d{2}$；示例：2025-01	回看历史月份产品数据，最长支持2024年1月起最多2年内数据, 选填，格式：yyyy-MM，不指定此参数时表示查实时数据，小于当月月份时为回看数据。AU BR IN暂不支持回看，US GB DE支持"不限"模式回看，其余站点支持Top100产品回看
queryValue	string	否	最长 1000；示例：B0CVM8TXHP, 3743561, Anker, AnkerDirect, A294P4X9EWVXLJ, Power Bank, 1,1000, 100,1000	查询条件值，根据query和queryType不同而格式不同。 【当query=1（单条件查询）时】根据queryType传入对应值： queryType=1(ASIN同类): 传入ASIN，如 B0CVM8TXHP queryType=2(类目): 传入NodeId，如 3743561 queryType=3(品牌): 传入品牌名，如 Anker queryType=4(卖家名称): 传入卖家店铺名，如 AnkerDirect queryType=5(卖家ID): 传入SellerId，如 A294P4X9EWVXLJ queryType=6(ABA关键词): 传入关键词，如 Power Bank queryType=7(标题/属性包含词): 传入匹配词，如 10,000mAh 30W queryType=8(价格范围): 格式'最低,最高'(单位当地货币最小单位如美分)，如 1,1000 表示11000美分；省略一端表示不限，如 ,1000 表示不高于1000美分 queryType=9(月销量范围): 格式'最低,最高'，如 100,1000 表示月销量1001000；,1000 表示不高于1000 queryType=10(季节性产品): 传入月份(逗号分隔)，如 1,2,3 表示查询1/2/3月为旺季的季节性产品 queryType=11(上架时间范围): 格式'开始日期,结束日期'(yyyy-MM-dd)，如 2024-06-01,2024-12-01；省略结束日期如 2024-06-01, 表示晚于该日期 queryType=12(星级范围): 格式'最低,最高'，如 3,5 表示35星；4, 表示>=4星 queryType=13(评论数范围): 格式'最低,最高'，如 10,500 表示10500条；,500 表示少于500条 queryType=14(排名范围): 格式'大类最低,大类最高;小类最低,小类最高'，如 500,5000;1,100 表示大类排名5005000且小类排名1100 queryType=15(发货方式): 传入FBA或FBM(逗号分隔)，如 FBA,FBM queryType=16(子体数范围): 格式'最低,最高'，如 1,50 表示子体数1~50 【当query=2（多条件组合查询）时】传入JSON数组，每项包含QueryType和Content，如 [{"QueryType":1,"Content":"B0CVM8TXHP"},{"QueryType":8,"Content":"100,500"}]
marketplace	string	是	格式 us|gb|de|fr|in|ca|jp|es|it|mx|ae|au|br|sa；示例：us, gb, de, fr, in, ca, jp, es	亚马逊站点代码

MCP 调用示例

向以下地址发起 HTTP POST：

https://mcp-tool-gateway.linkfox.com/mcp/any-tool

请求体：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "/sorftime/amazon/productQuery",
    "arguments": {
      "marketplace": "us",
      "page": 1
    }
  }
}

示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。

输出字段

字段	类型	必填	约束/默认值	说明
msg	string	否		响应消息
code	integer	否		响应码（200表示成功）
page	integer	否		当前页码
type	string	否		渲染的样式
total	integer	否		总数
columns	array<object>	否		渲染的列
costTime	integer	否		接口耗时(毫秒)
products	array<object>	否		产品列表
costToken	integer	否		消耗的Token数量
pageCount	integer	否		总页数(最多200页)
requestConsumed	integer	否		消耗的请求数

嵌套输出结构：products

字段	类型	必填	约束/默认值	说明
asin	string	否		ASIN
size	array<any>	否		尺寸.外包装[最长边,第二长边,最短边]，单位cm
aPlus	boolean	否		有A+
brand	string	否		品牌
isFBA	boolean	否		是否FBA.Buybox卖家是否使用FBA物流
price	number	否		当前价格.未扣Coupon，单位为当地货币(如美元)
title	string	否		商品标题
coupon	integer	否		Coupon政策.值>0为抵扣金额(如500=$5)，值<0为折扣百分比(如-10=10%折扣)
rating	number	否		当前评分（0.0-5.0，如4.8）
weight	string	否		重量.单位g
asinUrl	string	否		商品链接.亚马逊Listing详情页URL
fbaFees	number	否		FBA费用.单位为当地货币(如美元)
ratings	integer	否		评分数量
category	array<any>	否

嵌套输出结构：products.bsrCategory

字段	类型	必填	约束/默认值	说明
date	string	否		日期.格式yyyyMMdd
name	string	否		类目名称
rank	string	否		排名
nodeId	string	否		节点ID

响应处理建议

1. 先检查 JSON-RPC 外层是否包含 error。
2. 成功时读取 result，并继续解析其中的 content、data、products、items 或其他业务字段。
3. 如果响应为 text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
4. 保留分页字段、总数、失败明细及 costToken。
5. 向用户输出分析结论，不要直接倾倒大段原始 JSON。

原始 Schema

原始的Input Schema 和 Output Schema 参考 references/schema.md

解决认证和积分问题

异常情况：未配置 LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。

措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。

注意：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要！