linkfox-dld-product-search

1688 商品搜索（DianLeiDa）

本技能将指导你如何在 1688 批发平台上搜索和分析商品，帮助电商卖家和采购专业人士找到优质供应商和有利润空间的商品。

核心概念

此工具提供基于关键词的 1688 商品搜索（1688 是中国最大的 B2B 批发平台）。它整合了商品列表、销量数据、价格阶梯、供应商资质和履约选项。数据来源于 DianLeiDa（店铺雷达分析），涵盖实时商品列表以及 7 天和 30 天销量指标。

关键术语：

• 批发价（price）：按最低起订量下单时的单价
• 一件代发价（consignPrice）：单件代发的单价（通常高于批发价）
• 诚信通年限（tpYear）：供应商持有阿里巴巴诚信通会员资格的年限，可反映其经营时间
• 销量（salesQuantity）：所选时间段内售出的商品总件数
• 订单数（salesOrderCount）：所选时间段内的独立订单总数
• 预估销售额（estimatedSalesAmount）：所选时间段内的预估收入

数据字段

字段	API 名称	描述	示例
商品标题	title	商品列表中的完整标题	...
商品 ID	offerId	1688 商品的唯一标识符	805578065498
商品 URL	asinUrl	商品列表的直接链接	https://detail.1688.com/...
图片 URL	imageUrl	商品主图	https://cbu01.alicdn.com/...
批发价	price	按批量订购数量计算的单价（CNY）	12.50
一件代发价	consignPrice	单件代发的单价（CNY）	18.90
价格阶梯	quantityPrices	按数量划分的价格明细	...
最低订购量	quantityBegin	最低订购数量	2
订单数	salesOrderCount	此时间段内的订单数	350
销量	salesQuantity	此时间段内售出的商品件数	1200
预估销售额	estimatedSalesAmount	此时间段内的预估收入	45000
发货时间	deliveryTime	承诺的发货时间	24h
上架日期	availableDate	商品首次上架的日期	2025-03-15
类目	levelName	商品类目路径	...
店铺名称	company	供应商／店铺名称	...
店铺 ID	shopId	店铺的唯一标识符	...
店铺 URL	shopUrl	供应商店铺链接	https://shop...
货币	currency	价格货币（始终为 CNY）	CNY
数据类型	dataType	时间段标识：weeklyData 或 monthlyData	monthlyData

参数指南

搜索关键词

这是最重要的参数。**关键词必须使用中文。**如果用户提供的是英文词语，请先将其翻译成中文，再进行查询。

• keyWord（字符串，最多 50 个字符）：中文搜索词
• searchType：1 = 模糊匹配（默认），3 = 精确匹配
• goodsUrl：通过商品 URL 搜索，而非关键词
• productIds：通过指定的商品 ID 搜索（逗号分隔，最多 20 个）

时间段

• cycle："7" 表示最近 7 天，"30" 表示最近 30 天

排序

• sortField：排序字段。默认值：orderCount30d
  • orderCount7d / orderCount30d —— 订单数
  • saleCount7d / saleCount30d —— 销量
  • saleVolume7d / saleVolume30d —— 预估收入
  • offerCreateTime —— 上架日期
  • price —— 批发价
  • consignPrice —— 一件代发价
• sortType："desc"（默认）或 "asc"

价格筛选

• beginPrice / endPrice：批发价范围（CNY）
• beginConsignPrice / endConsignPrice：一件代发价范围（CNY）

销量筛选

• beginOrderCount / endOrderCount：订单数范围
• beginSaleCount / endSaleCount：销量范围
• beginSaleVolume / endSaleVolume：收入范围（CNY）

供应商筛选条件

• companyType：0 = 任意（默认），1 = 店铺，2 = 工厂
• shiLiType：卖家等级。支持逗号分隔的多选：
  • superFactory -- 超级工厂
  • Power -- 实力商家
  • TrustPass -- 仅限 TrustPass 会员
• beginTpYear / endTpYear：TrustPass 会员年限范围

商品标签

• offerType：0 = 任意，2 = 新品，3 = 1688 严选，4 = 跨境商品，5 = 可定制，6 = 实力好店精选

履约与服务

• sendTime：发货速度。支持逗号分隔："24"、"48"、"72"
• faceToFaceSupport：平台面单支持。支持逗号分隔：
  • 441218（淘宝）、386434（抖音）、422914（拼多多）、422978（小红书）、386370（快手）
• proxyRights：一件代发权益。支持逗号分隔：
  • 4360897（包邮代发）、449154（先采后付）
• shopService：卖家服务。支持逗号分隔：
  • 4057409（无忧购）、888777（深度验厂报告）
• buyerProtections：买家保障。支持逗号分隔的中文字符串：
  • 商品包邮（包邮）、7天包退货（7 天退货）、支持运费险（运费险）

上架日期筛选

• beginOfferCreateTime / endOfferCreateTime：日期范围，格式为 YYYY-MM-DD

分页

• pageIndex：页码，从 1 开始（默认：1）
• pageSize：每页结果数，10-100（默认：20）

查询示例

1. 基本关键词搜索——“瑜伽垫”的热销商品

{"keyWord": "瑜伽垫", "cycle": "30", "sortField": "saleCount30d", "sortType": "desc", "pageSize": 20}

2. 仅搜索工厂，并设置价格范围

{"keyWord": "蓝牙耳机", "companyType": 2, "beginPrice": 10, "endPrice": 50, "cycle": "30", "sortField": "orderCount30d"}

3. 支持一件代发的跨境商品

{"keyWord": "手机壳", "offerType": 4, "proxyRights": "4360897", "cycle": "7", "sortField": "saleVolume7d"}

4. 最近上架的新品，按上架日期排序

{"keyWord": "夏季连衣裙", "offerType": 2, "sortField": "offerCreateTime", "sortType": "desc", "pageSize": 50}

5. 超级工厂的高销量商品

{"keyWord": "数据线", "shiLiType": "superFactory", "beginSaleCount": 1000, "cycle": "30", "sortField": "saleCount30d"}

6. 按商品 URL 搜索

{"goodsUrl": "https://detail.1688.com/offer/805578065498.html", "cycle": "30"}

展示规则

1. 清晰呈现数据：使用结构化表格展示结果，包含商品标题、价格、销售指标和供应商信息。附上商品 URL，方便用户直接访问商品页面。
2. 价格说明：如果有批发价和一件代发价，务必同时展示，方便用户比较利润空间。
3. 销售指标：根据使用的 cycle 参数，明确标注指标是 7 天还是 30 天的数据。
4. 图片展示：如果有 imageUrl，请展示商品图片，帮助用户直观地识别商品。
5. 分页提示：当 total 超过返回的页面大小时，告知用户结果总数，并说明可以请求更多页面。
6. 错误处理：如果查询返回错误，请解释问题并建议调整参数（例如放宽筛选条件或检查关键词拼写）。
7. 关键词翻译：如果用户提供英文商品关键词，请在调用 API 前翻译成中文，并在回复中说明该翻译。

适用场景

用户说	场景
"在 1688 上找 XX 的供应商"	商品关键词搜索
"1688 上什么商品卖得好？"	热销商品发现
"找工厂的便宜 XX"	使用价格筛选条件寻找工厂货源
"1688 上 XX 的一件代发供应商"	搜索支持一件代发的商品
"在 1688 上比较 XX 的价格"	比较不同供应商的价格
"1688 上的 XX 新品"	新品发现
"找适合跨境的 1688 商品"	跨境商品货源搜索
"哪些 1688 供应商能在 24 小时内发货？"	筛选发货速度
"找 XX 的顶级工厂"	搜索超级工厂 / 实力商家
"找这个 1688 商品"（附 URL 或 ID）	直接查询商品

不适用

• Amazon 或其他非 1688 平台的商品调研
• 1688 店铺层面的数据分析（店铺流量、店铺排名）
• 1688 广告或推广策略
• 商品评价或评分分析
• 物流成本计算或运费估算
• 下单或交易处理
• 用户已有本地商品数据文件需要分析

边界判断：当用户提到“采购”“寻找供应商”或“批发商品”，如果涉及在 1688 平台上通过价格、销量或供应商类型等筛选条件搜索特定商品，则适用此技能。如果用户需要的是店铺层面的数据分析、广告优化或商品搜索以外的运营支持，则不适用。

解决认证和算力问题

发生以下异常情况时，采用 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。