Sorftime-亚马逊产品详情(含趋势)
基本信息
- 业务工具名：
/sorftime/amazon/productDetail
- 所属分组：Sorftime · 亚马逊选品
- 功能说明：按亚马逊 ASIN 查询产品详情和趋势数据，核心数据包括：
- 关键词：Sorftime, 亚马逊产品详情，价格曲线, 销量走势, BSR排名历史, 利润分析, 价格历史
何时使用
当用户意图与“Sorftime-亚马逊产品详情(含趋势)”匹配，或需要以下能力时使用本工具：按亚马逊 ASIN 查询产品详情和趋势数据，核心数据包括：
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
输入参数
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
asin |
string |
是 |
最长 1000；示例：B0088PUEPK, B0088PUEPK,B00U26V4VQ |
亚马逊标准识别号(ASIN).支持多个ASIN查询（最多10个），以英文逗号隔开 |
marketplace |
string |
是 |
格式 us|gb|de|fr|in|ca|jp|es|it|mx|ae|au|br|sa；示例：us, gb, de, fr, in, ca, jp, es |
亚马逊站点代码 |
includeTrend |
integer |
否 |
默认 1；示例：1, 2 |
是否包含趋势数据.1：包含（默认）；2：不包含 |
queryTrendEndDate |
string |
否 |
格式 ^\d{4}-\d{2}-\d{2}$；示例：2025-03-01 |
趋势截止日期(yyyy-MM-dd) |
queryTrendStartDate |
string |
否 |
格式 ^\d{4}-\d{2}-\d{2}$；示例：2025-01-01 |
趋势开始日期(yyyy-MM-dd).默认仅返回近15天，查询天数>15天时扣费加倍 |
MCP 调用示例
向以下地址发起 HTTP POST：
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体：
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/sorftime/amazon/productDetail",
"arguments": {
"asin": "B0088PUEPK",
"marketplace": "us"
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
msg |
string |
否 |
|
响应消息 |
code |
integer |
否 |
|
响应码（200表示成功） |
type |
string |
否 |
|
渲染的样式 |
total |
integer |
否 |
|
总数 |
columns |
array<object> |
否 |
|
渲染的列 |
costTime |
integer |
否 |
|
接口耗时(毫秒) |
products |
array<object> |
否 |
|
产品详情列表 |
costToken |
integer |
否 |
|
消耗的Token数量 |
sourceType |
string |
否 |
|
来源类型 |
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.70） |
weight |
string |
否 |
|
重量.单位g |
asinUrl |
string |
否 |
|
商品链接.亚马逊Listing详情页URL |
fbaFees |
number |
否 |
|
FBA费用.单位为当地货币(如美元) |
feature |
object |
否 |
|
|
offSale |
integer |
否 |
|
是否下架.1=不可售，0=可售 |
ratings |
integer |
否 |
|
评分数量 |
category |
array<any> |
否 |
|
大类.[大类名称, NodeId] |
dealType |
string |
否 |
|
Deal标签 |
ebcPhoto |
array<any> |
否 |
|
A+图片 |
hasVideo |
boolean |
否 |
|
有视频 |
imageUrl |
string |
否 |
|
主图 |
property |
object |
否 |
|
|
shipCost |
number |
否 |
|
FBM配送费.单位为当地货币(如美元) |
attribute |
array<object> |
否 |
|
产品属性.有子体时表示子体属性 |
dealTrend |
array<any> |
否 |
|
Deal趋势.下标%2=0为日期，下标%2=1为状态(1:有Deal，0:无Deal) |
fbaDetail |
array<any> |
否 |
|
FBA明细.首项为配送费，后续为月份:仓储费，如[475,1-9:5,10-12:15] |
rankTrend |
array<any> |
否 |
|
BSR趋势.大类排名变化历史 |
salesRank |
integer |
否 |
|
BSR排名 |
sellerNum |
integer |
否 |
|
卖家数 |
shipsFrom |
string |
否 |
|
发货方 |
storeName |
string |
否 |
|
店铺名称 |
lastUpdate |
string |
否 |
|
更新时间.ASIN数据最近采集时间（格式yyyy-MM-dd） |
onlineDays |
integer |
否 |
|
上架天数 |
parentAsin |
string |
否 |
|
父ASIN.有子体时为父级ASIN，无子体时为null |
priceTrend |
array<any> |
否 |
|
售价趋势.未扣Coupon，单位为当地货币最小单位，-1表示该日无可用价格 |
profitRate |
number |
否 |
|
利润率.例25.83表示25.83% |
sourceTool |
string |
否 |
|
来源工具 |
sourceType |
string |
否 |
|
来源类型 |
bsrCategory |
array<object> |
否 |
|
小类排名列表 |
description |
string |
否 |
|
五点描述 |
platformFee |
number |
否 |
|
平台佣金.单位为当地货币(如美元) |
productInfo |
object |
否 |
|
|
productType |
string |
否 |
|
分类.亚马逊产品类目节点名称 |
bsrRankTrend |
array<object> |
否 |
|
小类排名趋势.JSON格式，示例: [{NodeId:xxx, Rank:[日期,排名,...]}] |
buyboxSeller |
string |
否 |
|
Buybox卖家 |
extraSavings |
array<object> |
否 |
|
关联促销.如[{Asin:xxx, Text:Save 5%...}] |
productBadge |
array<any> |
否 |
|
产品标志.如Amazon Choice、Best Seller、New Release等 |
profitAmount |
number |
否 |
|
利润.到手价-FBA费-佣金，单位为当地货币(如美元) |
variationNum |
integer |
否 |
|
变体数 |
availableDate |
string |
否 |
|
上架时间.格式yyyy-MM-dd |
hasBrandStore |
boolean |
否 |
|
有品牌店 |
variationASIN |
array<any> |
否 |
|
子体ASIN列表.无子体时为null |
brandPromotion |
string |
否 |
|
品牌促销 |
buyBoxSellerId |
string |
否 |
|
Buybox卖家ID |
listPriceTrend |
array<any> |
否 |
|
原价趋势.划线价历史，单位为当地货币最小单位，-1表示该日无可用价格 |
oneStarRatings |
number |
否 |
|
1星占比.例15.5表示15.5% |
twoStarRatings |
number |
否 |
|
2星占比.例8.0表示8.0% |
fiveStarRatings |
number |
否 |
|
5星占比.例57.7表示57.7% |
fourStarRatings |
number |
否 |
|
4星占比.例12.3表示12.3% |
productImageUrls |
array<any> |
否 |
|
主图列表 |
threeStarRatings |
number |
否 |
|
3星占比.例6.5表示6.5% |
monthlySalesUnits |
integer |
否 |
|
官方月销量.亚马逊公布的ASIN月销量，取近7个自然日最新值，无则为0 |
buyboxSellerAddress |
string |
否 |
|
卖家所在地.Buybox卖家国籍(二字码如CN、US)，亚马逊自营时为null |
listingSalesOfDailyTrend |
array<any> |
否 |
|
日销售额趋势.单位为当地货币最小单位(如美分)，下标%2=0为日期，下标%2=1为预计日销售额 |
listingSalesOfMonthTrend |
array<any> |
否 |
|
月销售额趋势.单位为当地货币最小单位，下标%2=0为日期，下标%2=1为预计月销售额 |
listingSalesVolumeOfDailyTrend |
array<any> |
否 |
|
日销量趋势.下标%2=0为日期，下标%2=1为预计日销量，值为-1表示无法预估 |
listingSalesVolumeOfMonthTrend |
array<any> |
否 |
|
月销量趋势.近30日销量，下标%2=0为日期，下标%2=1为月销量，值为-1表示无法预估 |
嵌套输出结构：products.attribute
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
asin |
string |
否 |
|
子体ASIN |
name |
string |
否 |
|
属性名 |
value |
string |
否 |
|
属性值 |
嵌套输出结构：products.bsrCategory
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
date |
string |
否 |
|
日期.格式yyyyMMdd |
name |
string |
否 |
|
类目名称 |
rank |
string |
否 |
|
排名 |
nodeId |
string |
否 |
|
节点ID |
响应处理建议
- 先检查 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。这非常重要！
1---2name: linkfox-sorftime-amazon-product-detail-23description: 基于Sorftime数据按ASIN查询亚马逊产品详情与历史趋势，涵盖14个站点。当用户提到Sorftime产品详情、ASIN详情查询、销量走势、价格曲线、价格历史、BSR排名历史、BSR趋势、利润分析、FBA费用分析、毛利率、产品趋势分析、日销量月销量、销售额趋势、Deal促销历史、product detail, sales trend, price history, BSR ranking, profit analysis, FBA fees时触发此技能。即使用户未明确提及\"Sorftime\"，只要其需求涉及按ASIN查询亚马逊产品详情或历史趋势数据，也应触发此技能。4---5
6# Sorftime-亚马逊产品详情(含趋势)
7
8## 基本信息
9
10- **业务工具名**：`/sorftime/amazon/productDetail`
11- **所属分组**：Sorftime · 亚马逊选品
12- **功能说明**：按亚马逊 ASIN 查询产品详情和趋势数据，核心数据包括：
13- **关键词**：Sorftime, 亚马逊产品详情，价格曲线, 销量走势, BSR排名历史, 利润分析, 价格历史
14
15
16## 何时使用
17
18当用户意图与“Sorftime-亚马逊产品详情(含趋势)”匹配，或需要以下能力时使用本工具：按亚马逊 ASIN 查询产品详情和趋势数据，核心数据包括：
19
20调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
21
22## 输入参数
23
24| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
25|---|---|:---:|---|---|
26| `asin` | `string` | 是 | 最长 1000；示例：`B0088PUEPK`, `B0088PUEPK,B00U26V4VQ` | 亚马逊标准识别号(ASIN).支持多个ASIN查询（最多10个），以英文逗号隔开 |
27| `marketplace` | `string` | 是 | 格式 `us\|gb\|de\|fr\|in\|ca\|jp\|es\|it\|mx\|ae\|au\|br\|sa`；示例：`us`, `gb`, `de`, `fr`, `in`, `ca`, `jp`, `es` | 亚马逊站点代码 |
28| `includeTrend` | `integer` | 否 | 默认 `1`；示例：`1`, `2` | 是否包含趋势数据.1：包含（默认）；2：不包含 |
29| `queryTrendEndDate` | `string` | 否 | 格式 `^\d{4}-\d{2}-\d{2}$`；示例：`2025-03-01` | 趋势截止日期(yyyy-MM-dd) |
30| `queryTrendStartDate` | `string` | 否 | 格式 `^\d{4}-\d{2}-\d{2}$`；示例：`2025-01-01` | 趋势开始日期(yyyy-MM-dd).默认仅返回近15天，查询天数>15天时扣费加倍 |
31
32
33## MCP 调用示例
34
35向以下地址发起 HTTP `POST`：
36
37```text
38https://mcp-tool-gateway.linkfox.com/mcp/any-tool
39```
40
41请求体：
42
43```json
44{
45 "jsonrpc": "2.0",
46 "id": 1,
47 "method": "tools/call",
48 "params": {
49 "name": "/sorftime/amazon/productDetail",
50 "arguments": {
51 "asin": "B0088PUEPK",
52 "marketplace": "us"
53 }
54 }
55}
56```
57
58> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
59
60## 输出字段
61
62| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
63|---|---|:---:|---|---|
64| `msg` | `string` | 否 | | 响应消息 |
65| `code` | `integer` | 否 | | 响应码（200表示成功） |
66| `type` | `string` | 否 | | 渲染的样式 |
67| `total` | `integer` | 否 | | 总数 |
68| `columns` | `array<object>` | 否 | | 渲染的列 |
69| `costTime` | `integer` | 否 | | 接口耗时(毫秒) |
70| `products` | `array<object>` | 否 | | 产品详情列表 |
71| `costToken` | `integer` | 否 | | 消耗的Token数量 |
72| `sourceType` | `string` | 否 | | 来源类型 |
73| `requestConsumed` | `integer` | 否 | | 消耗的请求数 |
74
75### 嵌套输出结构：`products`
76
77| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
78|---|---|:---:|---|---|
79| `asin` | `string` | 否 | | ASIN |
80| `size` | `array<any>` | 否 | | 尺寸.外包装[最长边,第二长边,最短边]，单位cm |
81| `aPlus` | `boolean` | 否 | | 有A+ |
82| `brand` | `string` | 否 | | 品牌 |
83| `isFBA` | `boolean` | 否 | | 是否FBA.Buybox卖家是否使用FBA物流 |
84| `price` | `number` | 否 | | 销售价.扣除Coupon后的实际售价，单位为当地货币(如美元) |
85| `title` | `string` | 否 | | 商品标题 |
86| `coupon` | `integer` | 否 | | Coupon政策.值>0为抵扣金额(如500=$5)，值<0为折扣百分比(如-10=10%折扣) |
87| `rating` | `number` | 否 | | 当前评分（0.0-5.0，如4.70） |
88| `weight` | `string` | 否 | | 重量.单位g |
89| `asinUrl` | `string` | 否 | | 商品链接.亚马逊Listing详情页URL |
90| `fbaFees` | `number` | 否 | | FBA费用.单位为当地货币(如美元) |
91| `feature` | `object` | 否 | | |
92| `offSale` | `integer` | 否 | | 是否下架.1=不可售，0=可售 |
93| `ratings` | `integer` | 否 | | 评分数量 |
94| `category` | `array<any>` | 否 | | 大类.[大类名称, NodeId] |
95| `dealType` | `string` | 否 | | Deal标签 |
96| `ebcPhoto` | `array<any>` | 否 | | A+图片 |
97| `hasVideo` | `boolean` | 否 | | 有视频 |
98| `imageUrl` | `string` | 否 | | 主图 |
99| `property` | `object` | 否 | | |
100| `shipCost` | `number` | 否 | | FBM配送费.单位为当地货币(如美元) |
101| `attribute` | `array<object>` | 否 | | 产品属性.有子体时表示子体属性 |
102| `dealTrend` | `array<any>` | 否 | | Deal趋势.下标%2=0为日期，下标%2=1为状态(1:有Deal，0:无Deal) |
103| `fbaDetail` | `array<any>` | 否 | | FBA明细.首项为配送费，后续为月份:仓储费，如[475,1-9:5,10-12:15] |
104| `rankTrend` | `array<any>` | 否 | | BSR趋势.大类排名变化历史 |
105| `salesRank` | `integer` | 否 | | BSR排名 |
106| `sellerNum` | `integer` | 否 | | 卖家数 |
107| `shipsFrom` | `string` | 否 | | 发货方 |
108| `storeName` | `string` | 否 | | 店铺名称 |
109| `lastUpdate` | `string` | 否 | | 更新时间.ASIN数据最近采集时间（格式yyyy-MM-dd） |
110| `onlineDays` | `integer` | 否 | | 上架天数 |
111| `parentAsin` | `string` | 否 | | 父ASIN.有子体时为父级ASIN，无子体时为null |
112| `priceTrend` | `array<any>` | 否 | | 售价趋势.未扣Coupon，单位为当地货币最小单位，-1表示该日无可用价格 |
113| `profitRate` | `number` | 否 | | 利润率.例25.83表示25.83% |
114| `sourceTool` | `string` | 否 | | 来源工具 |
115| `sourceType` | `string` | 否 | | 来源类型 |
116| `bsrCategory` | `array<object>` | 否 | | 小类排名列表 |
117| `description` | `string` | 否 | | 五点描述 |
118| `platformFee` | `number` | 否 | | 平台佣金.单位为当地货币(如美元) |
119| `productInfo` | `object` | 否 | | |
120| `productType` | `string` | 否 | | 分类.亚马逊产品类目节点名称 |
121| `bsrRankTrend` | `array<object>` | 否 | | 小类排名趋势.JSON格式，示例: [{NodeId:xxx, Rank:[日期,排名,...]}] |
122| `buyboxSeller` | `string` | 否 | | Buybox卖家 |
123| `extraSavings` | `array<object>` | 否 | | 关联促销.如[{Asin:xxx, Text:Save 5%...}] |
124| `productBadge` | `array<any>` | 否 | | 产品标志.如Amazon Choice、Best Seller、New Release等 |
125| `profitAmount` | `number` | 否 | | 利润.到手价-FBA费-佣金，单位为当地货币(如美元) |
126| `variationNum` | `integer` | 否 | | 变体数 |
127| `availableDate` | `string` | 否 | | 上架时间.格式yyyy-MM-dd |
128| `hasBrandStore` | `boolean` | 否 | | 有品牌店 |
129| `variationASIN` | `array<any>` | 否 | | 子体ASIN列表.无子体时为null |
130| `brandPromotion` | `string` | 否 | | 品牌促销 |
131| `buyBoxSellerId` | `string` | 否 | | Buybox卖家ID |
132| `listPriceTrend` | `array<any>` | 否 | | 原价趋势.划线价历史，单位为当地货币最小单位，-1表示该日无可用价格 |
133| `oneStarRatings` | `number` | 否 | | 1星占比.例15.5表示15.5% |
134| `twoStarRatings` | `number` | 否 | | 2星占比.例8.0表示8.0% |
135| `fiveStarRatings` | `number` | 否 | | 5星占比.例57.7表示57.7% |
136| `fourStarRatings` | `number` | 否 | | 4星占比.例12.3表示12.3% |
137| `productImageUrls` | `array<any>` | 否 | | 主图列表 |
138| `threeStarRatings` | `number` | 否 | | 3星占比.例6.5表示6.5% |
139| `monthlySalesUnits` | `integer` | 否 | | 官方月销量.亚马逊公布的ASIN月销量，取近7个自然日最新值，无则为0 |
140| `buyboxSellerAddress` | `string` | 否 | | 卖家所在地.Buybox卖家国籍(二字码如CN、US)，亚马逊自营时为null |
141| `listingSalesOfDailyTrend` | `array<any>` | 否 | | 日销售额趋势.单位为当地货币最小单位(如美分)，下标%2=0为日期，下标%2=1为预计日销售额 |
142| `listingSalesOfMonthTrend` | `array<any>` | 否 | | 月销售额趋势.单位为当地货币最小单位，下标%2=0为日期，下标%2=1为预计月销售额 |
143| `listingSalesVolumeOfDailyTrend` | `array<any>` | 否 | | 日销量趋势.下标%2=0为日期，下标%2=1为预计日销量，值为-1表示无法预估 |
144| `listingSalesVolumeOfMonthTrend` | `array<any>` | 否 | | 月销量趋势.近30日销量，下标%2=0为日期，下标%2=1为月销量，值为-1表示无法预估 |
145
146### 嵌套输出结构：`products.attribute`
147
148| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
149|---|---|:---:|---|---|
150| `asin` | `string` | 否 | | 子体ASIN |
151| `name` | `string` | 否 | | 属性名 |
152| `value` | `string` | 否 | | 属性值 |
153
154### 嵌套输出结构：`products.bsrCategory`
155
156| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
157|---|---|:---:|---|---|
158| `date` | `string` | 否 | | 日期.格式yyyyMMdd |
159| `name` | `string` | 否 | | 类目名称 |
160| `rank` | `string` | 否 | | 排名 |
161| `nodeId` | `string` | 否 | | 节点ID |
162
163## 响应处理建议
164
1651. 先检查 JSON-RPC 外层是否包含 `error`。
1662. 成功时读取 `result`，并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1673. 如果响应为 `text/event-stream`，按 SSE 事件读取 `data:` 内容，再解析 JSON。
1684. 保留分页字段、总数、失败明细及 `costToken`。
1695. 向用户输出分析结论，不要直接倾倒大段原始 JSON。
170
171## 原始 Schema
172
173原始的Input Schema 和 Output Schema 参考 references/schema.md
174
175## 解决认证和积分问题
176
177异常情况：未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
178
179措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
180
181**注意**：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要！
ahang1598