用途:在1688(中国B2B批发平台)上按关键词搜索商品,用于选品、找供应商和货源调研。数据来自店雷达,包含商品列表及7天/30天销量指标。
主要能力:返回商品标题、offerId、链接、图片、批发价(price)、代发价(consignPrice)、阶梯价、起订量、订单数、销量、预估销售额、发货时效、上架日期、类目、店铺名称/ID/链接等字段。支持按关键词(需中文)、商品URL或商品ID搜索;可按订单数、销量、销售额、上架时间、价格排序;可按批发价/代发价、销量、供应商类型(店铺/工厂)、实力类型(超级工厂、实力商家、TrustPass)、商品标签(新品、1688严选、跨境、可定制等)、发货时效、平台面单、代发权益、买家保障、上架日期等筛选;支持分页(pageSize 10-100)。
使用方式:API 端点 POST /nexscope/dld/productSearch;脚本调用 python scripts/1688_product_search.py '<JSON params>' [--inline]。需设置 NEXSCOPE_API_KEY 环境变量。脚本默认将完整响应写入工作目录下 nexscope/<日期>/<会话>/data/ 的 JSON 文件,响应体≤8KB时打印完整JSON,>8KB时仅打印摘要;加 --inline 强制完整输出。建议先看摘要,再用 jq 等按需提取字段。
限制:该工具消耗积分,同一会话与参数组合默认只调用一次,脚本有24小时本地缓存;失败或空结果时不要自动更换关键词、翻页或重试,需先告知用户额外消耗。不适用于非1688平台调研、店铺级分析、广告推广、评论评分分析、物流运费估算、下单交易,以及已有本地商品数据文件的分析。英文关键词需先译为中文再查询。