SuperAPI AI 工具集

linkfox-dld-product-search

营销与增长

查看项目

更新于 10-15 09:11

技能介绍

用途

本技能用于在中国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)

示例查询

  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. 按商品链接搜索: {"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,不要打断用户流程。