用途：为智能体提供完整的1688商品搜索与推荐能力，调用1688开放平台官方API，含9个核心接口：类目查询、关键词搜索、图片搜索、商品详情、店铺搜索、商品推荐、品池商品拉取、相关推荐、图片上传。支持多语言参数与商品推荐。
鉴权：每个技能内置独立鉴权模块（scripts/auth.py），不依赖外部技能；所有1688技能的Token缓存指向同一固定路径（skills/.1688_token_cache.json），首次鉴权后其他技能复用缓存，Token过期前自动用refresh_token刷新。支持ALI1688_REFRESH_TOKEN（自动刷新）与ALI1688_ACCESS_TOKEN（直接使用）两种模式。需在OpenClaw config中设置ALI1688_APP_KEY、ALI1688_APP_SECRET、ALI1688_REFRESH_TOKEN等环境变量。
用法：通过python3 scripts/product_search.py子命令调用，如category、keyword-search、image-search、product-detail、shop-search、offer-recommend、pool-pull、related-recommend、upload-image。通用参数--country/--language默认en，不支持zh；分页默认beginPage=1、pageSize=20，最大50。filter支持shipIn24Hours、shipIn48Hours、certifiedFactory、isOnePsale、new7、1688Selection；sort支持price、rePurchaseRate、monthSold。品池拉取需pool-id与task-id必填，分页需固定同一taskId。
图片搜索：支持本地文件、imageId、图片URL三种方式，优先本地文件；大于300KB自动压缩转JPEG至300KB以内并临时清理。官方提示imageBase64方式对本地截图/外部图片可能返回无效imageId（"0"），alicdn.com域名可直接用imageAddress图搜。
限制：每个查询最多返回2000个商品；商品详情每次仅支持1个商品ID；排序仅对当前页有效；API返回原价，下单享营销价；country/language不支持zh；品池需业务定制与访问权限。结果须透出offerId与商品链接，失败返回错误JSON并以退出码1结束，不返回mock数据。AppKey/AppSecret/Token的获取流程与错误处理见资料。