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，如 B0CVM8TXHPqueryType=2(类目): 传入NodeId，如 3743561queryType=3(品牌): 传入品牌名，如 AnkerqueryType=4(卖家名称): 传入卖家店铺名，如 AnkerDirectqueryType=5(卖家ID): 传入SellerId，如 A294P4X9EWVXLJqueryType=6(ABA关键词): 传入关键词，如 Power BankqueryType=7(标题/属性包含词): 传入匹配词，如 10,000mAh 30WqueryType=8(价格范围): 格式'最低,最高'(单位当地货币最小单位如美分)，如 1,1000 表示11000美分；省略一端表示不限，如 ,1000 表示不高于1000美分queryType=9(月销量范围): 格式'最低,最高'，如 100,1000 表示月销量1001000；,1000 表示不高于1000queryType=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 表示35星；4, 表示>=4星queryType=13(评论数范围): 格式'最低,最高'，如 10,500 表示10500条；,500 表示少于500条queryType=14(排名范围): 格式'大类最低,大类最高;小类最低,小类最高'，如 500,5000;1,100 表示大类排名5005000且小类排名1100queryType=15(发货方式): 传入FBA或FBM(逗号分隔)，如 FBA,FBMqueryType=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：
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体：
{
"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<object> |
否 |
|
渲染的列 |
costTime |
integer |
否 |
|
接口耗时(毫秒) |
products |
array<object> |
否 |
|
产品列表 |
costToken |
integer |
否 |
|
消耗的Token数量 |
pageCount |
integer |
否 |
|
总页数(最多200页) |
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.8） |
weight |
string |
否 |
|
重量.单位g |
asinUrl |
string |
否 |
|
商品链接.亚马逊Listing详情页URL |
fbaFees |
number |
否 |
|
FBA费用.单位为当地货币(如美元) |
ratings |
integer |
否 |
|
评分数量 |
category |
array<any> |
否 |
|
大类.[大类名称, NodeId] |
hasVideo |
boolean |
否 |
|
有视频 |
imageUrl |
string |
否 |
|
主图 |
oldPrice |
number |
否 |
|
划线价.单位为当地货币(如美元) |
fbaDetail |
array<any> |
否 |
|
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<object> |
否 |
|
小类排名列表 |
platformFee |
number |
否 |
|
平台佣金.单位为当地货币(如美元) |
buyboxSeller |
string |
否 |
|
Buybox卖家 |
profitAmount |
number |
否 |
|
利润.到手价-FBA费-佣金，单位为当地货币(如美元) |
variationNum |
integer |
否 |
|
变体数 |
availableDate |
string |
否 |
|
上架时间.格式yyyy-MM-dd |
hasBrandStore |
boolean |
否 |
|
有品牌店 |
buyBoxSellerId |
string |
否 |
|
Buybox卖家ID |
productImageUrls |
array<any> |
否 |
|
主图列表 |
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 |
响应处理建议
- 先检查 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-query-23description: 基于Sorftime数据的亚马逊多维度产品搜索与筛选，涵盖14个站点，支持历史月份快照回看。当用户提到Sorftime产品搜索、亚马逊产品筛选、竞品调研、类目分析、品牌热销、卖家分析、季节性产品、历史快照回看、产品搜索、月销量月销额、ABA关键词找产品、价格范围筛选、新品发现、多条件组合筛选、product search, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot时触发此技能。即使用户未明确提及\"Sorftime\"，只要其需求涉及亚马逊产品搜索、筛选、对比或类目/品牌/卖家维度的产品探索，也应触发此技能。4---5
6# Sorftime-亚马逊产品搜索
7
8## 基本信息
9
10- **业务工具名**：`/sorftime/amazon/productQuery`
11- **所属分组**：Sorftime · 亚马逊选品
12- **功能说明**：支持多样化检索，基于 ASIN 找同类产品、类目/品牌/卖家追踪、ABA 关键词调研，以及标题/属性关键词匹配。数据涵盖：价格信息（原价、实际售价及 Coupon 政策）、BSR 排名趋势（支持大类及各细分小类排名追踪）、以及历史月度销量与销额。此外，该工具还提供 FBA 配送费/仓储费明细、平台佣金、产品毛利及毛利率，为定价策略调整、利润空间测算及库存计划提供核心数据支撑。
13- **关键词**：Sorftime, 产品筛选, 竞品调研, 类目分析, 历史快照,利润分析,FBA费用分析
14
15
16## 何时使用
17
18当用户意图与“Sorftime-亚马逊产品搜索”匹配，或需要以下能力时使用本工具：支持多样化检索，基于 ASIN 找同类产品、类目/品牌/卖家追踪、ABA 关键词调研，以及标题/属性关键词匹配。数据涵盖：价格信息（原价、实际售价及 Coupon 政策）、BSR 排名趋势（支持大类及各细分小类排名追踪）、以及历史月度销量与销额。此外，该工具还提供 FBA 配送费/仓储费明细、平台佣金、产品毛利及毛利率，为定价策略调整、利润空间测算及库存计划提供核心数据支撑。
19
20调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
21
22## 输入参数
23
24| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
25|---|---|:---:|---|---|
26| `page` | `integer` | 否 | 默认 `1`；最小 1 | 分页页码.每页最多100个产品，默认1 |
27| `queryMode` | `integer` | 否 | 默认 `1`；示例：`1`, `2` | 查询方式.1：单条件查询（默认）；2：多条件组合查询（且关系） |
28| `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:限定子体数范围查产品 |
29| `queryMonth` | `string` | 否 | 格式 `^\d{4}-\d{2}$`；示例：`2025-01` | 回看历史月份产品数据，最长支持2024年1月起最多2年内数据, 选填，格式：yyyy-MM，不指定此参数时表示查实时数据，小于当月月份时为回看数据。AU BR IN暂不支持回看，US GB DE支持"不限"模式回看，其余站点支持Top100产品回看 |
30| `queryValue` | `string` | 否 | 最长 1000；示例：`B0CVM8TXHP`, `3743561`, `Anker`, `AnkerDirect`, `A294P4X9EWVXLJ`, `Power Bank`, `1,1000`, `100,1000` | 查询条件值，根据query和queryType不同而格式不同。<br>【当query=1（单条件查询）时】根据queryType传入对应值：<br>queryType=1(ASIN同类): 传入ASIN，如 B0CVM8TXHP<br>queryType=2(类目): 传入NodeId，如 3743561<br>queryType=3(品牌): 传入品牌名，如 Anker<br>queryType=4(卖家名称): 传入卖家店铺名，如 AnkerDirect<br>queryType=5(卖家ID): 传入SellerId，如 A294P4X9EWVXLJ<br>queryType=6(ABA关键词): 传入关键词，如 Power Bank<br>queryType=7(标题/属性包含词): 传入匹配词，如 10,000mAh 30W<br>queryType=8(价格范围): 格式'最低,最高'(单位当地货币最小单位如美分)，如 1,1000 表示1~1000美分；省略一端表示不限，如 ,1000 表示不高于1000美分<br>queryType=9(月销量范围): 格式'最低,最高'，如 100,1000 表示月销量100~1000；,1000 表示不高于1000<br>queryType=10(季节性产品): 传入月份(逗号分隔)，如 1,2,3 表示查询1/2/3月为旺季的季节性产品<br>queryType=11(上架时间范围): 格式'开始日期,结束日期'(yyyy-MM-dd)，如 2024-06-01,2024-12-01；省略结束日期如 2024-06-01, 表示晚于该日期<br>queryType=12(星级范围): 格式'最低,最高'，如 3,5 表示3~5星；4, 表示>=4星<br>queryType=13(评论数范围): 格式'最低,最高'，如 10,500 表示10~500条；,500 表示少于500条<br>queryType=14(排名范围): 格式'大类最低,大类最高;小类最低,小类最高'，如 500,5000;1,100 表示大类排名500~5000且小类排名1~100<br>queryType=15(发货方式): 传入FBA或FBM(逗号分隔)，如 FBA,FBM<br>queryType=16(子体数范围): 格式'最低,最高'，如 1,50 表示子体数1~50<br>【当query=2（多条件组合查询）时】传入JSON数组，每项包含QueryType和Content，如 [{"QueryType":1,"Content":"B0CVM8TXHP"},{"QueryType":8,"Content":"100,500"}] |
31| `marketplace` | `string` | 是 | 格式 `us\|gb\|de\|fr\|in\|ca\|jp\|es\|it\|mx\|ae\|au\|br\|sa`；示例：`us`, `gb`, `de`, `fr`, `in`, `ca`, `jp`, `es` | 亚马逊站点代码 |
32
33
34## MCP 调用示例
35
36向以下地址发起 HTTP `POST`：
37
38```text
39https://mcp-tool-gateway.linkfox.com/mcp/any-tool
40```
41
42请求体：
43
44```json
45{
46 "jsonrpc": "2.0",
47 "id": 1,
48 "method": "tools/call",
49 "params": {
50 "name": "/sorftime/amazon/productQuery",
51 "arguments": {
52 "marketplace": "us",
53 "page": 1
54 }
55 }
56}
57```
58
59> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
60
61## 输出字段
62
63| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
64|---|---|:---:|---|---|
65| `msg` | `string` | 否 | | 响应消息 |
66| `code` | `integer` | 否 | | 响应码（200表示成功） |
67| `page` | `integer` | 否 | | 当前页码 |
68| `type` | `string` | 否 | | 渲染的样式 |
69| `total` | `integer` | 否 | | 总数 |
70| `columns` | `array<object>` | 否 | | 渲染的列 |
71| `costTime` | `integer` | 否 | | 接口耗时(毫秒) |
72| `products` | `array<object>` | 否 | | 产品列表 |
73| `costToken` | `integer` | 否 | | 消耗的Token数量 |
74| `pageCount` | `integer` | 否 | | 总页数(最多200页) |
75| `requestConsumed` | `integer` | 否 | | 消耗的请求数 |
76
77### 嵌套输出结构：`products`
78
79| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
80|---|---|:---:|---|---|
81| `asin` | `string` | 否 | | ASIN |
82| `size` | `array<any>` | 否 | | 尺寸.外包装[最长边,第二长边,最短边]，单位cm |
83| `aPlus` | `boolean` | 否 | | 有A+ |
84| `brand` | `string` | 否 | | 品牌 |
85| `isFBA` | `boolean` | 否 | | 是否FBA.Buybox卖家是否使用FBA物流 |
86| `price` | `number` | 否 | | 当前价格.未扣Coupon，单位为当地货币(如美元) |
87| `title` | `string` | 否 | | 商品标题 |
88| `coupon` | `integer` | 否 | | Coupon政策.值>0为抵扣金额(如500=$5)，值<0为折扣百分比(如-10=10%折扣) |
89| `rating` | `number` | 否 | | 当前评分（0.0-5.0，如4.8） |
90| `weight` | `string` | 否 | | 重量.单位g |
91| `asinUrl` | `string` | 否 | | 商品链接.亚马逊Listing详情页URL |
92| `fbaFees` | `number` | 否 | | FBA费用.单位为当地货币(如美元) |
93| `ratings` | `integer` | 否 | | 评分数量 |
94| `category` | `array<any>` | 否 | | 大类.[大类名称, NodeId] |
95| `hasVideo` | `boolean` | 否 | | 有视频 |
96| `imageUrl` | `string` | 否 | | 主图 |
97| `oldPrice` | `number` | 否 | | 划线价.单位为当地货币(如美元) |
98| `fbaDetail` | `array<any>` | 否 | | FBA明细.首项为配送费，后续为月份:仓储费，如[475,1-9:5,10-12:15] |
99| `salesRank` | `integer` | 否 | | BSR排名 |
100| `sellerNum` | `integer` | 否 | | 卖家数 |
101| `onlineDays` | `integer` | 否 | | 上架天数 |
102| `parentAsin` | `string` | 否 | | 父ASIN.有子体时为父级ASIN，无子体时为null |
103| `profitRate` | `number` | 否 | | 利润率.例25.83表示25.83% |
104| `salesPrice` | `number` | 否 | | 到手价.扣除Coupon后的实际售价，单位为当地货币(如美元) |
105| `sourceTool` | `string` | 否 | | 来源工具 |
106| `sourceType` | `string` | 否 | | 来源类型 |
107| `bsrCategory` | `array<object>` | 否 | | 小类排名列表 |
108| `platformFee` | `number` | 否 | | 平台佣金.单位为当地货币(如美元) |
109| `buyboxSeller` | `string` | 否 | | Buybox卖家 |
110| `profitAmount` | `number` | 否 | | 利润.到手价-FBA费-佣金，单位为当地货币(如美元) |
111| `variationNum` | `integer` | 否 | | 变体数 |
112| `availableDate` | `string` | 否 | | 上架时间.格式yyyy-MM-dd |
113| `hasBrandStore` | `boolean` | 否 | | 有品牌店 |
114| `buyBoxSellerId` | `string` | 否 | | Buybox卖家ID |
115| `productImageUrls` | `array<any>` | 否 | | 主图列表 |
116| `monthlySalesUnits` | `integer` | 否 | | 月销量.近30日Listing维度不区分子体，推荐用于评估销量，值为-1表示无法预估 |
117| `buyboxSellerAddress` | `string` | 否 | | 卖家所在地.Buybox卖家国籍(二字码如CN、US)，亚马逊自营时为null |
118| `listingSalesOfDaily` | `number` | 否 | | 日销售额.单位为当地货币(如美元)，值为-1表示无法预估 |
119| `monthlySalesRevenue` | `number` | 否 | | 月销售额.预估值，单位为当地货币(如美元)，值为-1表示无法预估 |
120| `listingSalesVolumeOfDaily` | `integer` | 否 | | 日销量.Listing维度不区分子体，值为-1表示无法预估 |
121
122### 嵌套输出结构：`products.bsrCategory`
123
124| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
125|---|---|:---:|---|---|
126| `date` | `string` | 否 | | 日期.格式yyyyMMdd |
127| `name` | `string` | 否 | | 类目名称 |
128| `rank` | `string` | 否 | | 排名 |
129| `nodeId` | `string` | 否 | | 节点ID |
130
131## 响应处理建议
132
1331. 先检查 JSON-RPC 外层是否包含 `error`。
1342. 成功时读取 `result`，并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1353. 如果响应为 `text/event-stream`，按 SSE 事件读取 `data:` 内容，再解析 JSON。
1364. 保留分页字段、总数、失败明细及 `costToken`。
1375. 向用户输出分析结论，不要直接倾倒大段原始 JSON。
138
139## 原始 Schema
140
141原始的Input Schema 和 Output Schema 参考 references/schema.md
142
143## 解决认证和积分问题
144
145异常情况：未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
146
147措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
148
149**注意**：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要！
ahang1598