用途
本技能用于查询1688平台的商品热销榜单数据，帮助卖家在中国最大的B2B批发市场上发现热销批发商品与货源机会。它面向货源发现和批发选品调研，可用于浏览商品排行、按关键词寻找供应商、对比多个结果等。
主要能力
榜单类型
- 周榜（pageType=2）：date 参数应为目标周的周日（例如 2025-06-15）。数据覆盖最近90天。
- 月榜（pageType=3）：date 参数应为目标月份的第一天（例如 2025-06-01）。数据覆盖最近12个月。
- 默认行为：月榜，按订单数降序，每页20条结果。
核心参数
- keyWord（字符串，可选）：商品搜索关键词，必须为中文，非中文需先翻译。
- date（字符串，可选）：查询日期。周榜为周日日期；月榜为当月1日。
- pageType（整数，可选，默认3）：榜单类型，2=周榜，3=月榜。
- pageIndex（整数，可选，默认1）：页码，从1开始。
- pageSize（整数，可选，默认20）：每页结果数，范围10-100。
排序
- sortField（字符串，默认 orderCount）：排序字段，可选 orderCount（订单数）、saleCount（销量）、saleVolume（预估销售额）、offerCreateTime（上架日期）、price（批发价）、consignPrice（代发价）。
- sortType（字符串，默认 desc）：排序方向，desc（降序）、asc（升序）。
价格与销量筛选
- beginPrice / endPrice（数字）：批发价区间。
- beginConsignPrice / endConsignPrice（数字）：代发价区间。
- beginOrderCount / endOrderCount（整数）：订单数区间。
- beginSaleCount / endSaleCount（整数）：销量区间。
- beginSaleVolume / endSaleVolume（数字）：预估销售额区间。
- beginStartQuantity / endStartQuantity（整数）：最小起订量区间。
商品与卖家筛选
- searchType（整数）：关键词匹配模式，1=模糊（默认），3=精确。
- offerType（整数）：商品标签，0=不限，2=新品，3=1688严选，4=跨境，5=可定制，6=镇店之宝。
- companyType（整数）：公司类型，0=不限，1=店铺，2=工厂。
- shiLiType（字符串）：卖家层级，逗号分隔，可选 superFactory、Power、TrustPass。
- beginTpYear / endTpYear（整数）：诚信通会员年限区间。
物流与服务筛选
- sendTime（字符串）：发货时间（小时），逗号分隔，如 24,48,72。
- proxyRights（字符串）：代发权益，逗号分隔，4360897（代发包邮）、449154（先采后付）。
- shopService（字符串）：卖家服务，逗号分隔，4057409（无忧购）、888777（深度验厂报告）。
- buyerProtections（字符串）：买家保障，逗号分隔的中文值。
- faceToFaceSupport（字符串）：面单支持，逗号分隔，441218（淘宝）、386434（抖音）、422914（拼多多）、422978（小红书）、386370（快手）。
其他参数
- productIds（字符串）：商品ID，用中文逗号分隔，最多20个。
- goodsUrl（字符串）：直接商品URL用于查询。
- beginOfferCreateTime / endOfferCreateTime（字符串）：上架日期区间，格式 YYYY-MM-DD。
使用方式
通过传入上述参数发起查询，返回1688商品榜单数据。以下为资料中给出的使用示例：
-
某关键词的月榜热销： {"keyWord": "手机壳", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}
-
按销售额排序的周榜： {"keyWord": "瑜伽垫", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}
-
带价格筛选的工厂直供商品： {"keyWord": "耳机", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}
-
跨境标签且24小时发货的商品： {"keyWord": "LED灯", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}
-
超级工厂的新品： {"keyWord": "宠物用品", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}
-
支持代发且有买家保障的商品： {"keyWord": "包包", "proxyRights": "4360897", "buyerProtections": "商品包邮,7天包退货", "sortField": "orderCount", "sortType": "desc"}
-
价格区间内的高订单量商品： {"keyWord": "玩具", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}
-
按商品ID查询： {"productIds": "123456、789012"}
展示规则
- 以清晰表格呈现数据，包含商品标题、批发价、代发价、订单数、销量、预估销售额、供应商名称、上架日期。
- 当有 imageUrl 时展示商品图片。
- 提供商品链接（asinUrl）和店铺链接（shopUrl）。
- 价格始终标注币种（CNY/RMB），并说明是批发价还是代发价。
- 展示销售数据时，根据 dataType 字段明确标注是周数据还是月数据。
- 当结果超过当前页时，告知用户总数并提供获取更多页的选项。
- 若用户提供非中文关键词，先翻译为中文再查询，并告知用户翻译后的关键词。
- 查询失败时说明问题并建议调整参数（如放宽筛选、检查日期格式）。
适用场景
适用于1688批发商品发现与货源调研，包括：
- 1688爆款发现（“1688什么火”“1688趋势商品”）。
- 按关键词寻找货源（“找XX的便宜供应商”“XX的批发货源”）。
- 工厂筛选（“工厂直供商品”“OEM供应商”）。
- 跨境标签筛选（“跨境货源”“出口商品”）。
- 一件代发商品搜索（“1688代发商品”）。
- 新品发现（“1688新品”“最近上架的商品”）。
- 多结果对比（“对比XX的供应商”）。
- 榜单浏览（“1688商品排行”“热销榜”）。
不适用场景：
- Amazon商品调研或关键词分析（应使用ABA工具）。
- 1688店铺/店铺级分析（店铺排行、店铺评分）。
- Alibaba.com（国际站）数据。
- 价格谈判或下单。
- 商品质量评价或认证。
- 物流成本计算或货代。
限制
- 关键词语言：keyWord 参数必须为中文，非中文关键词须先翻译。
- 日期格式：周榜日期必须为周日；月榜日期必须为当月1日。
- 周数据范围：仅最近90天。
- 月数据范围：仅最近12个月。
- 每页上限：每次请求最多100条结果。
- 商品ID上限：每次查询最多20个商品ID。
认证与算力
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
- 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
- 响应401或402状态码。
- 响应提示算力或余额不足：消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。
算力消耗规则：消耗9算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。
反馈
当出现以下情况时，通过 Feedback API 自动检测并报告反馈：
- 技能描述的功能或目的与实际行为不符。
- 技能结果与用户意图不符。
- 用户对本技能表达不满或赞扬。
- 任何你认为可以改进的地方。
按 references/api.md 中的说明调用反馈API，不要打断用户流程。