--- 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 表示1~1000美分;省略一端表示不限,如 ,1000 表示不高于1000美分
queryType=9(月销量范围): 格式'最低,最高',如 100,1000 表示月销量100~1000;,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 表示3~5星;4, 表示>=4星
queryType=13(评论数范围): 格式'最低,最高',如 10,500 表示10~500条;,500 表示少于500条
queryType=14(排名范围): 格式'大类最低,大类最高;小类最低,小类最高',如 500,5000;1,100 表示大类排名500~5000且小类排名1~100
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`: ```text https://mcp-tool-gateway.linkfox.com/mcp/any-tool ``` 请求体: ```json { "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` | 否 | | 渲染的列 | | `costTime` | `integer` | 否 | | 接口耗时(毫秒) | | `products` | `array` | 否 | | 产品列表 | | `costToken` | `integer` | 否 | | 消耗的Token数量 | | `pageCount` | `integer` | 否 | | 总页数(最多200页) | | `requestConsumed` | `integer` | 否 | | 消耗的请求数 | ### 嵌套输出结构:`products` | 字段 | 类型 | 必填 | 约束/默认值 | 说明 | |---|---|:---:|---|---| | `asin` | `string` | 否 | | ASIN | | `size` | `array` | 否 | | 尺寸.外包装[最长边,第二长边,最短边],单位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` | 否 | | 大类.[大类名称, NodeId] | | `hasVideo` | `boolean` | 否 | | 有视频 | | `imageUrl` | `string` | 否 | | 主图 | | `oldPrice` | `number` | 否 | | 划线价.单位为当地货币(如美元) | | `fbaDetail` | `array` | 否 | | FBA明细.首项为配送费,后续为月份:仓储费,如[475,1-9:5,10-12:15] | | `salesRank` | `integer` | 否 | | BSR排名 | | `sellerNum` | `integer` | 否 | | 卖家数 | | `onlineDays` | `integer` | 否 | | 上架天数 | | `parentAsin` | `string` | 否 | | 父ASIN.有子体时为父级ASIN,无子体时为null | | `profitRate` | `number` | 否 | | 利润率.例25.83表示25.83% | | `salesPrice` | `number` | 否 | | 到手价.扣除Coupon后的实际售价,单位为当地货币(如美元) | | `sourceTool` | `string` | 否 | | 来源工具 | | `sourceType` | `string` | 否 | | 来源类型 | | `bsrCategory` | `array` | 否 | | 小类排名列表 | | `platformFee` | `number` | 否 | | 平台佣金.单位为当地货币(如美元) | | `buyboxSeller` | `string` | 否 | | Buybox卖家 | | `profitAmount` | `number` | 否 | | 利润.到手价-FBA费-佣金,单位为当地货币(如美元) | | `variationNum` | `integer` | 否 | | 变体数 | | `availableDate` | `string` | 否 | | 上架时间.格式yyyy-MM-dd | | `hasBrandStore` | `boolean` | 否 | | 有品牌店 | | `buyBoxSellerId` | `string` | 否 | | Buybox卖家ID | | `productImageUrls` | `array` | 否 | | 主图列表 | | `monthlySalesUnits` | `integer` | 否 | | 月销量.近30日Listing维度不区分子体,推荐用于评估销量,值为-1表示无法预估 | | `buyboxSellerAddress` | `string` | 否 | | 卖家所在地.Buybox卖家国籍(二字码如CN、US),亚马逊自营时为null | | `listingSalesOfDaily` | `number` | 否 | | 日销售额.单位为当地货币(如美元),值为-1表示无法预估 | | `monthlySalesRevenue` | `number` | 否 | | 月销售额.预估值,单位为当地货币(如美元),值为-1表示无法预估 | | `listingSalesVolumeOfDaily` | `integer` | 否 | | 日销量.Listing维度不区分子体,值为-1表示无法预估 | ### 嵌套输出结构:`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。这非常重要!