用途
本技能用于在中国1688批发平台(阿里巴巴国内B2B市场)上搜索和分析商品,主要面向电商卖家、采购人员和选品从业者,帮助其寻找货源、发现供应商并进行选品调研。
主要能力
该工具提供基于关键词的1688商品搜索,聚合商品列表及销量数据、阶梯价格、供应商资质和履约选项。数据来源于店雷达(DianLeiDa),覆盖实时商品列表及7天、30天销售指标。
可获取的数据字段包括:商品标题、商品ID、商品链接、主图链接、批发价、代发价、阶梯价格、最小起订量、订单数、销量、预估销售额、发货时间、上架日期、类目、店铺名称、店铺ID、店铺链接、币种(固定为CNY)、数据类型(weeklyData或monthlyData)。
关键术语:
- 批发价(price):按最小起批量下单时的单价
- 代发价(consignPrice):单件代发的单价,通常高于批发价
- 诚信通年限(tpYear):供应商持有阿里巴巴诚信通会员的年数,反映经营年限
- 销量(salesQuantity):所选时间段内的总销售件数
- 订单数(salesOrderCount):所选时间段内的独立订单总数
- 预估销售额(estimatedSalesAmount):所选时间段内的预估收入
使用方式
搜索关键词
最重要的参数,关键词必须为中文。若用户提供英文词,需先翻译为中文再查询。
- keyWord(字符串,最长50字符):中文搜索词
- searchType:1=模糊匹配(默认),3=精确匹配
- goodsUrl:按商品链接搜索
- productIds:按指定商品ID搜索(逗号分隔,最多20个)
时间周期
- cycle:"7"表示最近7天,"30"表示最近30天
排序
- sortField:排序字段,默认orderCount30d
- orderCount7d / orderCount30d:订单数
- saleCount7d / saleCount30d:销量
- saleVolume7d / saleVolume30d:预估销售额
- offerCreateTime:上架日期
- price:批发价
- consignPrice:代发价
- sortType:"desc"(默认)或"asc"
价格筛选
- beginPrice / endPrice:批发价范围(人民币)
- beginConsignPrice / endConsignPrice:代发价范围(人民币)
销量筛选
- beginOrderCount / endOrderCount:订单数范围
- beginSaleCount / endSaleCount:销量范围
- beginSaleVolume / endSaleVolume:销售额范围(人民币)
供应商筛选
- companyType:0=不限(默认),1=店铺,2=工厂
- shiLiType:卖家层级,逗号分隔多选
- superFactory:超级工厂
- Power:实力商家
- TrustPass:仅诚信通会员
- beginTpYear / endTpYear:诚信通会员年限范围
商品标签
- 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天包退货、支持运费险
上架日期筛选
- beginOfferCreateTime / endOfferCreateTime:日期范围,格式YYYY-MM-DD
分页
- pageIndex:页码,从1开始(默认1)
- pageSize:每页结果数,10-100(默认20)
示例查询
-
基础关键词搜索——"瑜伽垫"热销榜: {"keyWord": "瑜伽垫", "cycle": "30", "sortField": "saleCount30d", "sortType": "desc", "pageSize": 20}
-
仅工厂、带价格范围: {"keyWord": "蓝牙耳机", "companyType": 2, "beginPrice": 10, "endPrice": 50, "cycle": "30", "sortField": "orderCount30d"}
-
跨境商品且支持代发: {"keyWord": "手机壳", "offerType": 4, "proxyRights": "4360897", "cycle": "7", "sortField": "saleVolume7d"}
-
近期新品,按上架日期排序: {"keyWord": "夏季连衣裙", "offerType": 2, "sortField": "offerCreateTime", "sortType": "desc", "pageSize": 50}
-
超级工厂高销量商品: {"keyWord": "数据线", "shiLiType": "superFactory", "beginSaleCount": 1000, "cycle": "30", "sortField": "saleCount30d"}
-
按商品链接搜索: {"goodsUrl": "https://detail.1688.com/offer/805578065498.html", "cycle": "30"}
展示规则
- 以结构化表格清晰呈现数据:商品标题、价格、销量指标和供应商信息,并附商品链接
- 价格上下文:同时展示批发价和代发价(如有),便于比较利润空间
- 销量指标:根据所用cycle参数明确标注是7天还是30天数据
- 图片展示:有imageUrl时展示商品图片
- 分页提示:当总数超过返回页大小时,告知用户总数及可请求更多页
- 错误处理:查询出错时说明问题并建议调整参数(如放宽筛选、检查关键词拼写)
- 关键词翻译:用户提供英文商品词时,先翻译为中文再调用API,并在回复中说明该翻译
适用场景
- "在1688上找XX的供应商"——关键词商品搜索
- "1688上什么卖得好"——热销商品发现
- "找工厂的便宜XX"——带价格筛选的工厂货源
- "1688上XX的一件代发供应商"——支持代发的商品搜索
- "对比1688上XX的价格"——跨供应商价格对比
- "1688上XX的新品"——新品发现
- "找1688跨境商品"——跨境货源
- "哪些1688供应商24小时内发货"——发货速度筛选
- "XX的头部工厂"——超级工厂/实力商家搜索
- "找这个1688商品"(带链接或ID)——直接商品查询
限制
不适用于以下情况:
- 亚马逊或其他非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自动检测并报告反馈:
- 本技能描述的功能或目的与实际行为不符
- 技能结果与用户意图不符
- 用户对本技能表达不满或赞扬
- 任何你认为可以改进的地方
按references/api.md中的说明调用反馈API,不要打断用户流程。