linkfox-sellersprite-product-search

name	linkfox-sellersprite-product-search
description	使用卖家精灵数据搜索和筛选亚马逊商品，支持价格、月销量、BSR排名、毛利率、评分、配送方式、标签、卖家来源等多维度条件，覆盖多个亚马逊站点。当用户提到亚马逊选品调研、产品筛选、销量过滤、产品发掘、BSR分析、小众商品发现、竞品分析、市场机会评估、按商品维度的市场规模估算、毛利率筛选、SellerSprite product selection, Amazon product selection, sales filtering, BSR analysis, profit screening, market analysis, product selection tool时触发此技能。即使用户未明确提及"卖家精灵"，只要其需求涉及筛选和分析亚马逊商品级数据进行选品，也应触发此技能。

卖家精灵-选产品

基本信息

• 业务工具名：/sellersprite/productSearch
• 所属分组：卖家精灵 · 亚马逊选品
• 功能说明：支持按价格、月销量、数据快照年月、分页、毛利率、关键词、类目名称等条件来筛选亚马逊的商品。
• 关键词：卖家精灵, 亚马逊选品, 选产品, 销量筛选, 市场分析, 过滤, 词组匹配, 选品工具, 功能需求调研, 市场机会点, 选品决策

何时使用

当用户意图与“卖家精灵-选产品”匹配，或需要以下能力时使用本工具：支持按价格、月销量、数据快照年月、分页、毛利率、关键词、类目名称等条件来筛选亚马逊的商品。

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

输入参数

字段	类型	必填	约束/默认值	说明
uid	string	否	最长 1000	用户id
page	integer	否	默认 1	页码，从1开始
size	integer	否	默认 20；最小 10；最大 100	每页条数,返回10-100条数据
order	object	否
chatId	string	否	最长 1000	对话id
maxBsr	integer	否		大类BSR最高排名
maxFba	number	否	最小 0	最高FBA运费
minBsr	integer	否		大类BSR最低排名
minFba	number	否	最小 0	最低FBA运费
teamId	string	否	最长 1000	团队id
keyword	string	否	最长 10240	关键字；请尽量翻译为对应国家的语言，比如美国用英语关键词，德国用德语关键词等等
maxPrice	number	否	最小 0	最高价格
maxUnits	integer	否	最小 0	最高月销量
minPrice	number	否	最小 0	最低价格
minUnits	integer	否	最小 0	最低月销量
matchType	integer	否	默认 1；示例：1, 2, 3	匹配方式，1词组匹配 2模糊匹配 3精准匹配；默认 1
maxProfit	number	否	最小 1；最大 100	最大毛利率,单位 %，利润率最小为1 ，最大为100
maxRating	number	否	最小 0；最大 5	最高评分值。评分最大为5分，最小0分，3.8-4.3为产品改良机会的产品
minProfit	number	否	最小 1；最大 100	最小毛利率，单位 %。利润率最小为1 ，最大为100
minRating	number	否	最小 0；最大 5	最低评分值。评分最大为5分，最小0分
nodeLabel	string	否	最长 1000	亚马逊类目名称
requestId	string	否	最长 1000	推送id
maxAmzUnit	integer	否	最小 0	最高子体近30日销量(仅近30日查询支持)
maxRatings	integer	否	最小 0；最大 10000	最高评分数
maxRevenue	number	否	最小 0	最高月销售额
maxSellers	integer	否		最大卖家数量，卖家数量小于等于
maxWeights	number	否	最小 0	最大重量
minAmzUnit	integer	否	最小 0	最低子体近30日销量(仅近30日查询支持)
minRatings	integer	否	最小 0；最大 10000	最低评分数
minRevenue	number	否	最小 0	最低月销售额
minSellers	integer	否		最小卖家数量,卖家数量大于等于
minWeights	number	否	最小 0	最小重量
nodeIdPath	string	否	最长 1000	亚马逊类目节点id
weightUnit	string	否	格式 g|kg|oz|lb；示例：g, kg, oz, lb	重量单位。支持的有：g/kg/oz/lb 这几种，如果用户的参数里面有重量，则必须要求用户也输入重量的单位。
fulfillment	string	否	最长 1000；示例：AMZ, FBA, FBM, AMZ,FBA, AMZ,FBM, FBA,FBM, AMZ,FBA,FBM, ``	配送方式，多条件查询用逗号隔开AMZ or FBA or FBM
marketplace	string	否	默认 "US"；格式 US|UK|DE|FR|JP|CA|IT|ES|MX|IN；示例：US, UK, DE, FR, JP, CA, IT, ES	市场
sellerNation	string	否	最长 1000；示例：US, DE, FR, JP, CN, HK, ``	卖家所属地，默认不限制，多条件查询用逗号隔开
dimensionType	string	否	最长 1000	包装尺寸类型, 参数信息如下 美国站点: SS-小号标准尺寸, LS-大号标准尺寸, SO-小号大件, MO-中号大件, LO/LB-大号大件, SP-特殊大件, O-其他尺寸, ELO-超大尺寸：0至50磅, EL5O-超大尺寸：50到70磅（不含50磅）, EL7O-超大尺寸：70至150磅（不含70磅）, EL15O-超大尺寸：150磅以上（不含150磅）; 日本站点: SM-小号, ST-标准, OV-大件, SS-超大尺寸, O-其他尺寸; 加拿大站点: EN-信封装, ST-标准, SO-小号大件, MO-中号大件, LO-大号大件, SP-特殊大件, O-其他尺寸; 英国/法国/德国/意大利/西班牙站点: SL-小号信封, NL-标准信封, LL-大号信封, ELL-超大号信封, SM-小包裹, SD-标准包裹, SB-小号大件, NB-标准大件, LB-大号大件, SPO-特殊大件, O-其他尺寸
excludeBrands	string	否	最长 10240	排除品牌
filterSubNode	boolean	否	示例：true, false	是否筛选子类目节点，true为筛选，false为不筛选，只有在nodeLabel 或 nodeIdPath 有值时才会生效
includeBrands	string	否	最长 10240	包含品牌
maxVariations	integer	否		最高变体数
minVariations	integer	否		最低变体数
showVariation	string	否	默认 "N"；最长 1000；示例：Y, N	是否查询变体
excludeSellers	string	否	最长 10240	排除卖家
includeSellers	string	否	最长 10240	包含卖家
badgeBestSeller	string	否	最长 1000；示例：Y, N, ``	是否有热销标识 Best Seller(Y/N)
badgeNewRelease	string	否	最长 1000；示例：Y, N, ``	是否有新品标识 New Release(Y/N)
excludeKeywords	string	否	最长 10240	排除关键词
maxBsrGrowthRate	number	否		BSR最高增长率，单位 %
minBsrGrowthRate	number	否		BSR最低增长率，单位 %
dataSnapshotMonth	string	否	默认 "nearly"；最长 1000；示例：nearly, 202412, 202501	亚马逊商品数据快照年月。指定查询特定历史时间点的商品数据快照，每个快照包含该月份所有在售商品的完整数据。格式：yyyyMM（如202412表示2024年12月所有在售商品的数据快照）。默认值 'nearly' 表示查询最近30天的实时数据。注意：数据快照是对特定月份亚马逊市场上所有在售商品的完整记录，用于历史分析和同期对比。仅支持查询已存在的历史快照，不支持未来日期。建议季节性分析时查询去年同期快照进行对比
maxBsrGrowthCount	integer	否		大类BSR最高增长数
maxSubNodeBsrRank	integer	否		子类目BSR最大排名 ，只有在 filterSubNode 为 true 是生效
minBsrGrowthCount	integer	否		BSR最低增长数
minSubNodeBsrRank	integer	否		子类目BSR最低排名 ，只有在 filterSubNode 为 true 是生效
badgeAmazonsChoice	string	否	最长 1000；示例：Y, N, ``	是否有热销标识 Amazon's Choice(Y/N)
maxUnitsGrowthRate	number	否		月销量最高增长率,单位 %
minUnitsGrowthRate	number	否		月销量最低增长率,单位 %
hideUnlistedProduct	boolean	否	默认 true；示例：true, false	是否隐藏已经下架的商品
maxRatingsGrowthCount	integer	否	最小 0	最高月新增评分数
minRatingsGrowthCount	integer	否	最小 0	最低月新增评分数
listedWithinLastMonths	integer	否	示例：1, 3, 6, 12, 24	上架时间范围（月），商品上架日期距离当前日期的月份范围筛选，仅支持枚举值：1（近1个月内上架）、3（近3个月内上架）、6（近6个月内上架）、12（近12个月内上架）、24（近24个月内上架）。如果传入的是具体日期，应先计算该日期距离当前时间的月份差，并取不超过上述枚举值的最大值
maxListingQualityScore	number	否	最小 0	最高 Listing 页面质量分
minListingQualityScore	number	否	最小 0	最低 Listing 页面质量分，

嵌套输入结构：order

字段	类型	必填	约束/默认值	说明
desc	string	是	默认 "true"；最长 1000	true为降序 false为升序
field	string	是	默认 "total_units"；最长 1000；示例：total_units, total_amount, bsr_rank, price, rating, reviews, profit, reviews_rate	排序字段

MCP 调用示例

向以下地址发起 HTTP POST：

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

请求体：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "/sellersprite/productSearch",
    "arguments": {
      "page": 1
    }
  }
}

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

输出字段

字段	类型	必填	约束/默认值	说明
type	string	否		渲染的样式
total	integer	否		总行数
columns	array<object>	否		渲染的列
keyword	string	否		对应筛选的关键词，如果有值，则表示这批数据是通过 这个关键词 keyword 搜索出来的
message	string	否		消息
products	array<object>	否		搜索结果产品列表
costToken	integer	否		消耗token
nodeLabel	string	否		亚马逊类目
nodeIdPath	string	否		搜索类目节点
sourceType	string	否		来源类型：amazon
dataSnapshotMonth	string	否		数据查询月份

嵌套输出结构：products

字段	类型	必填	约束/默认值	说明
bsr	integer	否		BSR 排名
fba	number	否		fba运费
sku	string	否		sku
asin	string	否		asin
badge	object	否
brand	string	否		品牌
price	number	否		价格
title	string	否		商品标题
nodeId	integer	否		节点id
profit	number	否		利润率
rating	number	否		评分
weight	string	否		重量
asinUrl	string	否		亚马逊asin的详情网址
keyword	string	否		对应筛选的关键词，如果有值，则表示这批数据是通过 这个关键词 keyword 搜索出来的
ratings

嵌套输出结构：products.badge

字段	类型	必填	约束/默认值	说明
ebc	string	否		A+页面(Y/N)
video	string	否		视频介绍(Y/N)
bestSeller	string	否		Best Seller标识(Y/N)
newRelease	string	否		release标识(Y/N)
amazonChoice	string	否		amazon choice标识(Y/N)

嵌套输出结构：products.subcategories

字段	类型	必填	约束/默认值	说明
code	string	否		类目code
rank	integer	否		排名
label	string	否		名称

响应处理建议

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。这非常重要！