linkfox-dld-product-billboard

DLD 商品排行榜（1688 畅销榜）

本技能将指导你如何查询 1688 平台商品畅销榜数据，帮助卖家在中国最大的 B2B 市场发现热销批发商品和采购机会。

核心概念

DLD 商品排行榜可访问 1688 平台的商品排名数据，涵盖周榜和月榜。用户可借此发现热门批发商品、比较供应商，并在中国国内批发市场中寻找采购机会。

排行榜类型：

• 周榜（pageType=2）：日期参数应为目标周的星期日（例如 2025-06-15）。可查询最近 90 天的数据。
• 月榜（pageType=3）：日期参数应为目标月份的第一天（例如 2025-06-01）。可查询最近 12 个月的数据。

默认行为：月榜，按订单数降序排列，每页显示 20 条结果。

参数指南

核心参数

参数	类型	必填	默认值	说明
keyWord	string	否	—	商品搜索关键词（必须使用中文；如果不是，请先翻译）
date	string	否	—	查询日期。周榜：星期日日期（例如 2025-06-15）；月榜：当月第一天（例如 2025-06-01）
pageType	integer	否	3	排行榜类型：2 = 周榜，3 = 月榜
pageIndex	integer	否	1	页码（从 1 开始）
pageSize	integer	否	20	每页结果数（10-100）

排序

参数	类型	默认值	说明
sortField	string	orderCount	排序字段：orderCount（订单数）、saleCount（销量）、saleVolume（预估销售额）、offerCreateTime（上架日期）、price（批发价）、consignPrice（一件代发价）
sortType	string	desc	排序顺序：desc（降序）、asc（升序）

价格和销量筛选条件

参数	类型	说明
beginPrice / endPrice	number	批发价范围
beginConsignPrice / endConsignPrice	number	一件代发价范围
beginOrderCount / endOrderCount	integer	订单数范围
beginSaleCount / endSaleCount	integer	销量范围
beginSaleVolume / endSaleVolume	number	预估销售额范围
beginStartQuantity / endStartQuantity	integer	起订量范围

商品和卖家筛选条件

参数	类型	说明
searchType	integer	关键词匹配模式：1 = 模糊匹配（默认），3 = 精确匹配
offerType	integer	商品标签：0 = 不限，2 = 新品，3 = 1688 严选，4 = 跨境，5 = 可定制，6 = 店铺宝贝
companyType	integer	公司类型：0 = 不限，1 = 店铺，2 = 工厂
shiLiType	string	卖家等级（逗号分隔）：superFactory、Power、TrustPass
beginTpYear / endTpYear	integer	诚信通会员年限范围

物流和服务筛选条件

参数	类型	说明
sendTime	string	发货时间（小时，逗号分隔）：24、48、72
proxyRights	string	一件代发权益（逗号分隔）：4360897（一件代发包邮）、449154（先采后付）
shopService	string	卖家服务（逗号分隔）：4057409（安心购）、888777（深度验厂报告）
buyerProtections	string	买家保障（中文值，以逗号分隔）
faceToFaceSupport	string	发货面单支持（逗号分隔）：441218（淘宝）、386434（抖音）、422914（拼多多）、422978（小红书）、386370（快手）

其他

参数	类型	说明
productIds	string	以中文逗号分隔的商品 ID，最多 20 个
goodsUrl	string	用于查询的商品直达链接
beginOfferCreateTime / endOfferCreateTime	string	商品上架日期范围（格式：YYYY-MM-DD）

使用示例

1. 查询某个关键词的月度热销商品

“查看本月 1688 上销量最高的手机壳”

{"keyWord": "手机壳", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}

2. 按营收排序的周榜

“上周瑜伽垫品类中哪些商品营收最高？”

{"keyWord": "瑜伽垫", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}

3. 按价格筛选的工厂直供商品

“查找 1688 上价格在 5 到 30 元之间的工厂直供耳机商品”

{"keyWord": "耳机", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}

4. 带跨境标签且发货快的商品

“查看带有跨境标签、24 小时内发货的 LED 灯商品”

{"keyWord": "LED灯", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}

5. 超级工厂的新商品

“查找宠物用品品类中超级工厂新上架的商品”

{"keyWord": "宠物用品", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}

6. 适合一件代发且提供买家保障的商品

“查看支持一件代发、包邮和退货保障的包袋商品”

{"keyWord": "包包", "proxyRights": "4360897", "buyerProtections": "商品包邮,7天包退货", "sortField": "orderCount", "sortType": "desc"}

7. 指定价格范围内的高销量商品

“查找玩具品类中订单量超过 1000 且批发价低于 50 元的商品”

{"keyWord": "玩具", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}

8. 按商品 ID 浏览

“查询这些指定的 1688 商品 ID：123456、789012”

{"productIds": "123456、789012"}

显示规则

1. 清晰呈现数据：使用结构清晰的表格展示商品结果，包括商品标题、批发价、一件代发价、订单数、销量、预估营收、供应商名称和上架日期
2. 图片显示：如果有 imageUrl，请显示商品图片，帮助用户直观识别商品
3. 提供链接：包含商品链接（asinUrl）和店铺链接（shopUrl），方便用户直接访问 1688 商品页面
4. 价格格式：始终注明价格的币种（CNY/RMB），并说明是批发价还是一件代发价
5. 销量数据说明：展示销售数据时，根据 dataType 字段清楚标明数据是周度还是月度
6. 分页说明：如果结果总数超过当前页，请告知用户结果总数，并询问是否需要获取更多页面
7. 关键词翻译：如果用户提供的关键词不是中文，请先将其翻译成中文再查询，并告知用户译后的关键词
8. 错误处理：查询失败时，说明问题并建议调整参数（例如扩大筛选范围、检查日期格式）

重要限制

• 关键词语言：keyWord 参数必须使用中文。查询前务必将非中文关键词翻译成中文。
• 日期格式很重要：周榜日期必须是星期日；月榜日期必须是当月 1 日。
• 周度数据范围：仅限最近 90 天。
• 月度数据范围：仅限最近 12 个月。
• 每页数量上限：每次请求最多返回 100 条结果。
• 商品 ID 数量限制：每次查询最多 20 个商品 ID。

用户表达与场景快速参考

适用——1688 批发商品发现与采购：

用户表达	场景
“1688 上有什么热门商品”“1688 热门商品”	热销商品发现
“找 XX 的低价供应商”“XX 的批发货源”	按关键词寻找货源
“工厂直供商品”“OEM 供应商”	工厂筛选
“跨境采购”“出口商品”	跨境标签筛选
“1688 上支持一件代发的商品”	搜索支持一件代发的商品
“1688 上的新商品”“最近上架的商品”	新品发现
“比较 XX 的供应商”	多结果对比
“1688 商品排行榜”“热销榜单”	浏览榜单

不适用——需求超出 1688 商品榜单数据范围：

• Amazon 商品调研或关键词分析（请改用 ABA 工具）
• 1688 店铺级分析（店铺排名、店铺评分）
• Alibaba.com（国际站）数据
• 价格谈判或下单
• 商品质量评价或认证
• 物流成本计算或货运代理

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码
• 响应提示算力或余额不足：消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。

算力消耗规则

消耗 9 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

在以下任一情况发生时，通过 Feedback API 自动检测并提交反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达对本技能的不满或赞扬
4. 任何你认为可以改进的地方

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

如需更多高品质、专业的跨境电商技能，请访问 LinkFox Skills。