在 1688 上搜索货源、供应商和选品时，按关键词、价格…

适用于在中国 1688 批发平台搜索商品、找货源/供应商、比价、一件代发、跨境选品和按销量/工厂/发货速度筛选的场景。

适用场景

解决思路

1. 用中文关键词查询 1688 商品：调用搜索时 keyWord 必须为中文，最大 50 字符。
2. 用户给英文商品词时，先翻译成中文再查询，并在响应中说明该翻译。
3. 选择匹配方式：searchType=1 模糊匹配（默认），searchType=3 精确匹配。
4. 支持按商品 URL 搜索：使用 goodsUrl。
5. 支持按商品 ID 搜索：使用 productIds，逗号分隔，最多 20 个。
6. 选择统计周期：cycle=7 查近 7 天，cycle=30 查近 30 天。
7. 排序：sortField 默认 orderCount30d；可选 orderCount7d、orderCount30d、saleCount7d、saleCount30d、saleVolume7d、saleVolume30d、offerCreateTime、price、consignPrice。
8. 排序方向：sortType=desc（默认）或 asc。
9. 批发价过滤：beginPrice/endPrice，单位 CNY。
10. 代发价过滤：beginConsignPrice/endConsignPrice，单位 CNY。
11. 订单数过滤：beginOrderCount/endOrderCount。
12. 销量过滤：beginSaleCount/endSaleCount。
13. 销售额过滤：beginSaleVolume/endSaleVolume，单位 CNY。
14. 供应商类型过滤：companyType=0 任意（默认）、1 店铺、2 工厂。
15. 卖家层级过滤：shiLiType 逗号分隔多选，superFactory 超级工厂、Power 实力商家、TrustPass 仅 TrustPass 会员。
16. TrustPass 年限过滤：beginTpYear/endTpYear。
17. 商品标签过滤：offerType=0 任意、2 新品、3 1688 Select、4 跨境、5 可定制、6 顶店精选。
18. 发货速度过滤：sendTime 逗号分隔，24、48、72。
19. 平台面单支持过滤：faceToFaceSupport 逗号分隔，441218=淘宝、386434=抖音、422914=拼多多、422978=小红书、386370=快手。
20. 代发权益过滤：proxyRights 逗号分隔，4360897=免邮代发、449154=先用后付。
21. 卖家服务过滤：shopService 逗号分隔，4057409=无忧购、888777=深度验厂报告。
22. 买家保障过滤：buyerProtections 逗号分隔中文，商品包邮、7天包退货、支持运费险。
23. 上架日期过滤：beginOfferCreateTime/endOfferCreateTime，格式 YYYY-MM-DD。
24. 分页：pageIndex 从 1 开始（默认 1）。
25. 每页数量：pageSize 10-100（默认 20）。
26. 示例-基础关键词搜索热销：keyWord=瑜伽垫，cycle=30，sortField=saleCount30d，sortType=desc，pageSize=20。
27. 示例-仅工厂并限定价格：keyWord=蓝牙耳机，companyType=2，beginPrice=10，endPrice=50，cycle=30，sortField=orderCount30d。
28. 示例-跨境且支持代发：keyWord=手机壳，offerType=4，proxyRights=4360897，cycle=7，sortField=saleVolume7d。
29. 示例-近期新品按上架日期：keyWord=夏季连衣裙，offerType=2，sortField=offerCreateTime，sortType=desc，pageSize=50。
30. 示例-超级工厂高销量：keyWord=数据线，shiLiType=superFactory，beginSaleCount=1000，cycle=30，sortField=saleCount30d。
31. 示例-按商品 URL 搜索：goodsUrl=https://detail.1688.com/offer/805578065498.html，cycle=30。
32. 读取并利用返回字段：title、offerId、asinUrl、imageUrl、price、consignPrice、quantityPrices、quantityBegin、salesOrderCount、salesQuantity、estimatedSalesAmount、deliveryTime、availableDate、levelName、company、shopId、shopUrl、currency、dataType。
33. 字段含义：price 为批发价，consignPrice 为一件代发价，tpYear 为 TrustPass 年限，salesQuantity 为销量，salesOrderCount 为订单数，estimatedSalesAmount 为预估销售额，dataType 表示 weeklyData 或 monthlyData。
34. 展示结果：用结构化表格展示商品标题、价格、销量指标和供应商信息，并包含商品 URL。
35. 价格展示：有批发价和代发价时都展示，便于用户比较利润。
36. 销量展示：根据 cycle 明确标注指标是 7 天还是 30 天。
37. 图片展示：有 imageUrl 时展示商品图片。
38. 分页提示：当 total 超过返回 pageSize 时，告知用户总结果数，并说明可请求更多页。
39. 错误处理：查询报错时解释问题，并建议调整参数，如放宽筛选、检查关键词拼写。
40. 操作映射-找供应商：用关键词商品搜索。
41. 操作映射-热销发现：用按销量或销售额排序。
42. 操作映射-找便宜工厂：用 companyType=2 加价格过滤。
43. 操作映射-一件代发：用 proxyRights=4360897 或查看/过滤 consignPrice。
44. 操作映射-比价：对比不同供应商的 price 和 consignPrice。
45. 操作映射-新品发现：用 offerType=2 或按 offerCreateTime 排序。
46. 操作映射-跨境选品：用 offerType=4。
47. 操作映射-发货速度：用 sendTime=24。
48. 操作映射-头部工厂：用 shiLiType=superFactory 或 Power。
49. 操作映射-按 URL/ID 查找：用 goodsUrl 或 productIds。
50. 异常认证处理：未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY，或响应 401/402，或提示算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值等，按 references/onboarding.md 引导解决。
51. 算力提醒：本技能消耗 9 算力；高频调用或用户对算力消耗预期不足时，提醒用户并由用户决定是否继续。
52. 反馈：当技能功能/目的与实际行为不符、结果不符合用户意图、用户表达不满或称赞、发现可改进处时，按 references/api.md 调用 Feedback API，不打断用户流程。
53. 需要更多跨境电商技能可访问 https://skill.linkfox.com/。

适用边界 · 注意事项

• 不适用 Amazon 或其他非 1688 平台的商品研究。
• 不适用 1688 店铺/店铺级分析（店铺流量、店铺排名）、广告或推广策略、评论/评分分析、物流成本/运费估算、下单/交易处理。
• 用户已有本地商品数据文件需要分析时，不适用。