店雷达-1688商品榜单
基本信息
- 业务工具名:
/dld/productBillboard
- 所属分组:店雷达 · 1688 选品
- 功能说明:支持1688平台的热销榜单查询,发现国内批发市场的爆款货源。
- 关键词:店雷达, 1688榜单, 1688热销, 货源榜单, 批发选品
何时使用
当用户意图与“店雷达-1688商品榜单”匹配,或需要以下能力时使用本工具:支持1688平台的热销榜单查询,发现国内批发市场的爆款货源。
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
输入参数
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
date |
string |
否 |
最长 1000 |
查询时间。如果是 周榜,则传入 需要查询 的 那周 的周天日期,如:2025-06-15,最长近90天;如果是 ⽉榜,则传入 需要查询的月份 的 第⼀天,如: 2025-06-01,(最长 可查询近⼀年) |
keyWord |
string |
否 |
最长 50 |
商品搜索关键字(搜索关键词必须是中文,如果不是请先翻译) |
endPrice |
number |
否 |
|
批发价(结束) |
goodsUrl |
string |
否 |
最长 1000 |
商品链接地址 |
pageSize |
integer |
否 |
默认 20;最大 100 |
每页返回数量(10-100) |
pageType |
integer |
否 |
默认 3;示例:3, 2 |
榜单类型: 2:周榜 3:月榜 |
sendTime |
string |
否 |
最长 1000;示例:24, 48, 72 |
发货时间(多选),多个使用“,”号隔开,如:24,48 |
sortType |
string |
否 |
默认 "desc";格式 desc|asc;示例:desc, asc |
排序类型:desc:降序,asc:升序 |
endTpYear |
integer |
否 |
|
结束诚信通年限 |
offerType |
integer |
否 |
默认 0;示例:0, 2, 3, 4, 5, 6 |
商品标识 0-不限制 2-新品 3-1688严选 4-跨境 5-支持定制 6-镇店之宝 |
pageIndex |
integer |
否 |
默认 1 |
页码(从1开始) |
shiLiType |
string |
否 |
最长 1000;示例:superFactory, Power, TrustPass |
卖家会员类型(多选),多个使用“,”号隔开,如:superFactory,Power |
sortField |
string |
否 |
默认 "orderCount";格式 orderCount|saleCount|saleVolume|offerCreateTime|price|consignPrice;示例:orderCount, saleCount, saleVolume, offerCreateTime, price, consignPrice |
排序字段 |
beginPrice |
number |
否 |
|
批发价(起始) |
productIds |
string |
否 |
最长 1000 |
商品ID 顿号隔开搜索多个,最多20个 |
searchType |
integer |
否 |
默认 1;示例:1, 3 |
商品关键词搜索类型 |
beginTpYear |
integer |
否 |
|
开始诚信通年限 |
companyType |
integer |
否 |
示例:0, 1, 2 |
公司类型 0-不限 1-店铺 2-工厂 |
proxyRights |
string |
否 |
最长 1000;示例:4360897, 449154 |
代发权益(多选),多个使用“,”号隔开,如:4360897,449154 |
shopService |
string |
否 |
最长 1000;示例:4057409, 888777 |
卖家服务(多选),多个使用“,”号隔开,如:4057409,888777 |
endSaleCount |
integer |
否 |
|
销售件数(结束) |
endOrderCount |
integer |
否 |
|
销售笔数(结束) |
endSaleVolume |
number |
否 |
|
销售额(结束) |
beginSaleCount |
integer |
否 |
|
销售件数(起始) |
beginOrderCount |
integer |
否 |
|
销售笔数(起始) |
beginSaleVolume |
number |
否 |
|
销售额(起始) |
endConsignPrice |
number |
否 |
|
代发价(结束) |
buyerProtections |
string |
否 |
最长 1000;示例:商品包邮, 7天包退货, 支持运费险 |
权益保障,多个用“,”隔开,如:商品包邮,7天包退货,支持运费险 |
endStartQuantity |
integer |
否 |
|
结束起批量 |
beginConsignPrice |
number |
否 |
|
代发价(起始) |
faceToFaceSupport |
string |
否 |
最长 1000;示例:441218, 386434, 422914, 422978, 386370 |
面单支持(多选),多个使用“,”号隔开,如:441218,386434 |
beginStartQuantity |
integer |
否 |
|
起始起批量 |
endOfferCreateTime |
string |
否 |
格式 ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$ |
上架时间(结束)例如:2025-06-11 |
beginOfferCreateTime |
string |
否 |
格式 ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$ |
上架时间(起始)例如:2025-06-11 |
MCP 调用示例
向以下地址发起 HTTP POST:
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/dld/productBillboard",
"arguments": {
"pageSize": 20,
"sortField": "orderCount",
"sortType": "desc"
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
type |
string |
否 |
|
渲染的样式 |
total |
integer |
否 |
|
记录数 |
columns |
array<object> |
否 |
|
渲染的列 |
products |
array<object> |
否 |
|
商品列表 |
costToken |
integer |
否 |
|
消耗token |
嵌套输出结构:products
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
asin |
string |
否 |
|
商品编号 |
unit |
string |
否 |
|
单位 |
price |
number |
否 |
|
批发价 |
title |
string |
否 |
|
商品标题 |
shopId |
string |
否 |
|
店铺id |
asinUrl |
string |
否 |
|
商品链接地址 |
company |
string |
否 |
|
店铺名称 |
offerId |
string |
否 |
|
商品id |
shopUrl |
string |
否 |
|
店铺链接地址 |
currency |
string |
否 |
|
币种 |
dataType |
string |
否 |
|
数据类型: weeklyData: 周数据; monthlyData: 月数据 |
imageUrl |
string |
否 |
|
图片地址 |
levelName |
string |
否 |
|
类目层级名称 |
sourceTool |
string |
否 |
|
来源工具 |
sourceType |
string |
否 |
|
1688 |
consignPrice |
number |
否 |
|
代发价 |
deliveryTime |
string |
否 |
|
发货时间 |
availableDate |
string |
否 |
格式 date |
商品上架时间,格式为 yyyy-MM-dd HH:mm:ss |
quantityBegin |
integer |
否 |
|
起批量 |
salesQuantity |
integer |
否 |
|
销售件数(按统计周期返回对应的值) |
quantityPrices |
string |
否 |
|
价格区间 |
salesOrderCount |
integer |
否 |
|
销售笔数(按统计周期返回对应的值) |
estimatedSalesAmount |
integer |
否 |
|
预估销售额(按统计周期返回对应的值) |
响应处理建议
- 先检查 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-dld-product-billboard-23description: 查询1688商品热销榜单数据,用于货源发现和批发选品调研。当用户提到1688商品排行、1688热销榜、批发爆款商品、国内货源榜单、一件代发选品、1688趋势商品、批量采购热门品、供应商商品排名、1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends时触发此技能。即使用户未明确提及"1688榜单",只要其需求涉及发现1688平台上的热销批发商品或货源机会,也应触发此技能。4---5
6# 店雷达-1688商品榜单
7
8## 基本信息
9
10- **业务工具名**:`/dld/productBillboard`
11- **所属分组**:店雷达 · 1688 选品
12- **功能说明**:支持1688平台的热销榜单查询,发现国内批发市场的爆款货源。
13- **关键词**:店雷达, 1688榜单, 1688热销, 货源榜单, 批发选品
14
15
16## 何时使用
17
18当用户意图与“店雷达-1688商品榜单”匹配,或需要以下能力时使用本工具:支持1688平台的热销榜单查询,发现国内批发市场的爆款货源。
19
20调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
21
22## 输入参数
23
24| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
25|---|---|:---:|---|---|
26| `date` | `string` | 否 | 最长 1000 | 查询时间。如果是 周榜,则传入 需要查询 的 那周 的周天日期,如:2025-06-15,最长近90天;如果是 ⽉榜,则传入 需要查询的月份 的 第⼀天,如: 2025-06-01,(最长 可查询近⼀年) |
27| `keyWord` | `string` | 否 | 最长 50 | 商品搜索关键字(搜索关键词必须是中文,如果不是请先翻译) |
28| `endPrice` | `number` | 否 | | 批发价(结束) |
29| `goodsUrl` | `string` | 否 | 最长 1000 | 商品链接地址 |
30| `pageSize` | `integer` | 否 | 默认 `20`;最大 100 | 每页返回数量(10-100) |
31| `pageType` | `integer` | 否 | 默认 `3`;示例:`3`, `2` | 榜单类型: 2:周榜 3:月榜 |
32| `sendTime` | `string` | 否 | 最长 1000;示例:`24`, `48`, `72` | 发货时间(多选),多个使用“,”号隔开,如:24,48 |
33| `sortType` | `string` | 否 | 默认 `"desc"`;格式 `desc\|asc`;示例:`desc`, `asc` | 排序类型:desc:降序,asc:升序 |
34| `endTpYear` | `integer` | 否 | | 结束诚信通年限 |
35| `offerType` | `integer` | 否 | 默认 `0`;示例:`0`, `2`, `3`, `4`, `5`, `6` | 商品标识 0-不限制 2-新品 3-1688严选 4-跨境 5-支持定制 6-镇店之宝 |
36| `pageIndex` | `integer` | 否 | 默认 `1` | 页码(从1开始) |
37| `shiLiType` | `string` | 否 | 最长 1000;示例:`superFactory`, `Power`, `TrustPass` | 卖家会员类型(多选),多个使用“,”号隔开,如:superFactory,Power |
38| `sortField` | `string` | 否 | 默认 `"orderCount"`;格式 `orderCount\|saleCount\|saleVolume\|offerCreateTime\|price\|consignPrice`;示例:`orderCount`, `saleCount`, `saleVolume`, `offerCreateTime`, `price`, `consignPrice` | 排序字段 |
39| `beginPrice` | `number` | 否 | | 批发价(起始) |
40| `productIds` | `string` | 否 | 最长 1000 | 商品ID 顿号隔开搜索多个,最多20个 |
41| `searchType` | `integer` | 否 | 默认 `1`;示例:`1`, `3` | 商品关键词搜索类型 |
42| `beginTpYear` | `integer` | 否 | | 开始诚信通年限 |
43| `companyType` | `integer` | 否 | 示例:`0`, `1`, `2` | 公司类型 0-不限 1-店铺 2-工厂 |
44| `proxyRights` | `string` | 否 | 最长 1000;示例:`4360897`, `449154` | 代发权益(多选),多个使用“,”号隔开,如:4360897,449154 |
45| `shopService` | `string` | 否 | 最长 1000;示例:`4057409`, `888777` | 卖家服务(多选),多个使用“,”号隔开,如:4057409,888777 |
46| `endSaleCount` | `integer` | 否 | | 销售件数(结束) |
47| `endOrderCount` | `integer` | 否 | | 销售笔数(结束) |
48| `endSaleVolume` | `number` | 否 | | 销售额(结束) |
49| `beginSaleCount` | `integer` | 否 | | 销售件数(起始) |
50| `beginOrderCount` | `integer` | 否 | | 销售笔数(起始) |
51| `beginSaleVolume` | `number` | 否 | | 销售额(起始) |
52| `endConsignPrice` | `number` | 否 | | 代发价(结束) |
53| `buyerProtections` | `string` | 否 | 最长 1000;示例:`商品包邮`, `7天包退货`, `支持运费险` | 权益保障,多个用“,”隔开,如:商品包邮,7天包退货,支持运费险 |
54| `endStartQuantity` | `integer` | 否 | | 结束起批量 |
55| `beginConsignPrice` | `number` | 否 | | 代发价(起始) |
56| `faceToFaceSupport` | `string` | 否 | 最长 1000;示例:`441218`, `386434`, `422914`, `422978`, `386370` | 面单支持(多选),多个使用“,”号隔开,如:441218,386434 |
57| `beginStartQuantity` | `integer` | 否 | | 起始起批量 |
58| `endOfferCreateTime` | `string` | 否 | 格式 `^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$` | 上架时间(结束)例如:2025-06-11 |
59| `beginOfferCreateTime` | `string` | 否 | 格式 `^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$` | 上架时间(起始)例如:2025-06-11 |
60
61
62## MCP 调用示例
63
64向以下地址发起 HTTP `POST`:
65
66```text
67https://mcp-tool-gateway.linkfox.com/mcp/any-tool
68```
69
70请求体:
71
72```json
73{
74 "jsonrpc": "2.0",
75 "id": 1,
76 "method": "tools/call",
77 "params": {
78 "name": "/dld/productBillboard",
79 "arguments": {
80 "pageSize": 20,
81 "sortField": "orderCount",
82 "sortType": "desc"
83 }
84 }
85}
86```
87
88> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
89
90## 输出字段
91
92| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
93|---|---|:---:|---|---|
94| `type` | `string` | 否 | | 渲染的样式 |
95| `total` | `integer` | 否 | | 记录数 |
96| `columns` | `array<object>` | 否 | | 渲染的列 |
97| `products` | `array<object>` | 否 | | 商品列表 |
98| `costToken` | `integer` | 否 | | 消耗token |
99
100### 嵌套输出结构:`products`
101
102| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
103|---|---|:---:|---|---|
104| `asin` | `string` | 否 | | 商品编号 |
105| `unit` | `string` | 否 | | 单位 |
106| `price` | `number` | 否 | | 批发价 |
107| `title` | `string` | 否 | | 商品标题 |
108| `shopId` | `string` | 否 | | 店铺id |
109| `asinUrl` | `string` | 否 | | 商品链接地址 |
110| `company` | `string` | 否 | | 店铺名称 |
111| `offerId` | `string` | 否 | | 商品id |
112| `shopUrl` | `string` | 否 | | 店铺链接地址 |
113| `currency` | `string` | 否 | | 币种 |
114| `dataType` | `string` | 否 | | 数据类型: weeklyData: 周数据; monthlyData: 月数据 |
115| `imageUrl` | `string` | 否 | | 图片地址 |
116| `levelName` | `string` | 否 | | 类目层级名称 |
117| `sourceTool` | `string` | 否 | | 来源工具 |
118| `sourceType` | `string` | 否 | | 1688 |
119| `consignPrice` | `number` | 否 | | 代发价 |
120| `deliveryTime` | `string` | 否 | | 发货时间 |
121| `availableDate` | `string` | 否 | 格式 `date` | 商品上架时间,格式为 yyyy-MM-dd HH:mm:ss |
122| `quantityBegin` | `integer` | 否 | | 起批量 |
123| `salesQuantity` | `integer` | 否 | | 销售件数(按统计周期返回对应的值) |
124| `quantityPrices` | `string` | 否 | | 价格区间 |
125| `salesOrderCount` | `integer` | 否 | | 销售笔数(按统计周期返回对应的值) |
126| `estimatedSalesAmount` | `integer` | 否 | | 预估销售额(按统计周期返回对应的值) |
127
128## 响应处理建议
129
1301. 先检查 JSON-RPC 外层是否包含 `error`。
1312. 成功时读取 `result`,并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1323. 如果响应为 `text/event-stream`,按 SSE 事件读取 `data:` 内容,再解析 JSON。
1334. 保留分页字段、总数、失败明细及 `costToken`。
1345. 向用户输出分析结论,不要直接倾倒大段原始 JSON。
135
136## 原始 Schema
137
138原始的Input Schema 和 Output Schema 参考 references/schema.md
139
140## 解决认证和积分问题
141
142异常情况:未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`;响应 401 或 402;消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
143
144措施:优先用 skill 内 onboarding.md 引导;找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
145
146**注意**:你是workbuddy,并且渠道是workbuddy,使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要!