SuperAPI AI 工具集

1688-product-search

数据与分析

查看项目

更新于 10-15 23:46

技能介绍

用途:通过1688开放平台官方API提供完整的商品搜索能力,包含9个核心接口,适用于选品、找同款、货源查询等场景。

主要能力:类目查询、多语言关键词搜索、多语言图片搜索、商品详情、店铺搜索、商品推荐、品池商品拉取、相关性商品推荐、上传图片获取imageId。支持筛选(24/48小时发货、认证工厂、一件代发、7天上新、1688严选)与排序(价格、复购率、月销量)。

使用方式:需在OpenClaw config中配置环境变量ALI1688_APP_KEY、ALI1688_APP_SECRET、ALI1688_REFRESH_TOKEN(或ALI1688_ACCESS_TOKEN)。鉴权模块位于scripts/auth.py,Token缓存路径为skills/.1688_token_cache.json,所有1688 Skill共用。常用命令示例:python3 scripts/product_search.py category 0;python3 scripts/product_search.py keyword-search "dress" --country en;python3 scripts/product_search.py image-search --image-path "/path/to/your/image.jpg" --country en;python3 scripts/product_search.py product-detail "offer_id";python3 scripts/product_search.py pool-pull --pool-id 111 --task-id 1 --page-no 1 --page-size 10。

限制:country/language不支持zh,默认en;商品详情每次仅支持1个商品;每个查询最多返回2000个商品;图片搜索推荐使用1688图片地址,其他域名成功率不稳定;品池拉取需offerPoolId和taskId及访问权限;API返回原价,下单享营销价;失败时返回错误JSON并退出码1,不返回mock数据。

适用场景:跨境电商选品、以图搜款、货源与供应商查询、商品推荐与品池拉取。

获取AppKey/AppSecret/Token需注册1688开放平台开发者、创建应用、订购解决方案并完成用户授权,具体步骤见资料。