| name | linkfox-sorftime-amazon-product-detail |
| description | 基于Sorftime数据按ASIN查询亚马逊产品详情与历史趋势,涵盖14个站点。当用户提到Sorftime产品详情、ASIN详情查询、销量走势、价格曲线、价格历史、BSR排名历史、BSR趋势、利润分析、FBA费用分析、毛利率、产品趋势分析、日销量月销量、销售额趋势、Deal促销历史、product detail, sales trend, price history, BSR ranking, profit analysis, FBA fees时触发此技能。即使用户未明确提及\"Sorftime\",只要其需求涉及按ASIN查询亚马逊产品详情或历史趋势数据,也应触发此技能。 |
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 | 否 |
嵌套输出结构: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。这非常重要!