1688-product-search

1# 1688商品搜索SKILL
2 
3通过1688开放平台官方API提供完整的商品搜索能力，包含9个核心接口。
4 
5## 鉴权说明
6 
7每个 Skill 内置独立的鉴权模块（`scripts/auth.py`），**不依赖任何外部 Skill**。
8 
9所有 1688 Skill 的 Token 缓存指向同一个固定路径，实现"独立运行 + 鉴权只发生一次"。
10 
11- Token 缓存路径: `skills/.1688_token_cache.json`（所有 1688 Skill 共用）
12- 任意一个 Skill 首次请求完成鉴权后，其他 Skill 直接复用缓存
13- Token 过期前自动用 refresh_token 刷新
14- 支持 `ALI1688_REFRESH_TOKEN`（自动刷新）和 `ALI1688_ACCESS_TOKEN`（直接使用）两种模式
15 
16### 配置
17 
18在 OpenClaw config 中设置环境变量：
19 
20```json5
21{
22 skills: {
23 entries: {
24 "1688-product-search": {
25 env: {
26 ALI1688_APP_KEY: "your-app-key",
27 ALI1688_APP_SECRET: "your-app-secret", 
28 ALI1688_REFRESH_TOKEN: "your-refresh-token"
29 }
30 }
31 }
32 }
33}
34```
35 
36### 如何获取 AppKey / AppSecret / Token
37 
38如果遇到 Token 相关错误（如 401、签名失败、Token 过期），按以下步骤操作：
39 
40#### Step 1：注册开发者 & 创建应用 → 获取 AppKey + AppSecret
41 
421. 打开 [1688开放平台](https://open.1688.com)，用1688账号登录
432. 进入 [控制中心](https://open.1688.com/console)
443. 点击「我的应用」→「创建应用」
454. 填写应用信息，提交审核
465. 审核通过后，在应用详情页可以看到 **AppKey** 和 **AppSecret**
47 
48#### Step 2：订购解决方案 → 获取 API 调用权限
49 
501. 打开 [跨境ERP/独立站SaaS数字化解决方案](https://open.1688.com/solution/solutionDetail.htm?solutionKey=1697015308755)
512. 点击「立即订购」，将解决方案绑定到你的应用
523. 订购成功后，应用才有权限调用方案内的 API
53 
54#### Step 3：用户授权 → 获取 access_token + refresh_token
55 
561. 在浏览器中访问授权页面（替换 YOUR_APPKEY 和 YOUR_REDIRECT_URI）：
57 ```
58 https://auth.1688.com/oauth/authorize?client_id=YOUR_APPKEY&site=1688&redirect_uri=YOUR_REDIRECT_URI
59 ```
602. 用1688账号登录并同意授权
613. 页面会跳转到你的回调地址，URL 中带有 `code` 参数
624. 用 code 换取 Token（有效期短，需在10分钟内使用）：
63 ```bash
64…