Imported from infometa/workbuddyskills (connectors/linkfox-product-selection/skills/linkfox-sellersprite-product-search/SKILL.md). Install upstream with npx skills add infometa/workbuddyskills --skill linkfox-sellersprite-product-search. Copyright stays with the author.

卖家精灵-选产品

基本信息

业务工具名：/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`	`integer`	否		评分数
`badgeEbc`	`string`	否		A+页面(Y/N)
`brandUrl`	`string`	否		品牌URL
`currency`	`string`	否		币种
`imageUrl`	`string`	否		图片URL
`sellerId`	`string`	否		BuyBox卖家id
`dimension`	`string`	否		尺寸
`sellerNum`	`integer`	否		卖家数
`badgeVideo`	`string`	否		视频介绍(Y/N)
`nodeIdPath`	`string`	否		节点id路径字符串
`primePrice`	`number`	否		prime价格
`sellerName`	`string`	否		BuyBox卖家
`sourceTool`	`string`	否		来源工具
`sourceType`	`string`	否		来源类型：amazon
`fulfillment`	`string`	否		配送方式(AMZ,FBA,FBM)
`ratingsRate`	`number`	否		留评率
`averagePrice`	`number`	否		平均价格
`sellerNation`	`string`	否		BuyBox卖家国籍
`variationNum`	`integer`	否		变体数
`availableDate`	`string`	否	格式 `date`	上架时间(时间戳)
`bsrGrowthRate`	`number`	否		BSR 增长率
`deliveryPrice`	`number`	否		卖家运费
`nodeLabelPath`	`string`	否		类目路径
`packageWeight`	`string`	否		包装重量
`subcategories`	`array<object>`	否		子类目
`dimensionsType`	`string`	否		尺寸类型
`badgeBestSeller`	`string`	否		Best Seller标识(Y/N)
`badgeNewRelease`	`string`	否		release标识(Y/N)
`badgeAmazonChoice`	`string`	否		amazon choice标识(Y/N)
`dataSnapshotMonth`	`string`	否		数据查询月份
`monthlySalesUnits`	`integer`	否		月销量
`packageDimensions`	`string`	否		包装尺寸
`variant30DayUnits`	`integer`	否		子体月销量(件数)
`availableDateString`	`string`	否		上架日期(字符串)
`listingQualityScore`	`number`	否		listing质量得分
`monthlySalesRevenue`	`number`	否		月销售额
`variant30DayRevenue`	`number`	否		子体月销售额(金额)
`packageDimensionType`	`string`	否		包装尺寸类型
`variant30DayUpdatedAt`	`string`	否		子体数据更新时间(日期)
`monthlySalesUnitsGrowthRate`	`number`	否		月销量增长率

嵌套输出结构：`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`	否	名称

响应处理建议

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

linkfox-sellersprite-product-search

About

卖家精灵-选产品

基本信息

何时使用

输入参数

嵌套输入结构：`order`

MCP 调用示例

输出字段

嵌套输出结构：`products`

嵌套输出结构：`products.badge`

嵌套输出结构：`products.subcategories`

响应处理建议

原始 Schema

解决认证和积分问题

Use it

Manifest

Reviews

About

卖家精灵-选产品

基本信息

何时使用

输入参数

嵌套输入结构：order

MCP 调用示例

输出字段

嵌套输出结构：products

嵌套输出结构：products.badge

嵌套输出结构：products.subcategories

响应处理建议

原始 Schema

解决认证和积分问题

Use it

Manifest

Reviews

嵌套输入结构：`order`

嵌套输出结构：`products`

嵌套输出结构：`products.badge`

嵌套输出结构：`products.subcategories`