1688-Product-to-Ozon

Files (14)

• README.md
• SKILL.md
• _meta.json
• offer_description.json · references/
• requirements.txt
• batch_translate.py · scripts/
• check_status.py · scripts/
• check_upload_status.py · scripts/
• queryCategoryMapping.py · scripts/
• queryDictionaryValues.py · scripts/
• queryOzonProperties.py · scripts/
• translate_images.py · scripts/
• upload_product.py · scripts/
• my_products.json · tmp/

SKILL.md (first lines)

# 1688到Ozon商品转换技能

## 技能描述

本技能用于将1688的商品转化为对应的俄罗斯电商平台Ozon的商品数据，产出一个可以用于操作Ozon的上架API的JSON结构化数据。
之后再通过Ozon的开放平台的接口将商品信息上传到Ozon平台并查询上传结果。可以把1688的商品铺货到Ozon，上架到Ozon，上传到Ozon、上架Ozon、Ozon商品发布、Ozon产品上传、查询Ozon上传结果、铺货、1688商品铺货。

触发词：上传到Ozon、上架Ozon、Ozon商品发布、Ozon产品上传、查询Ozon上传结果、铺货、1688商品铺货。


## 什么时候使用

用户说需要铺货到Ozon、上架到Ozon、上传到Ozon、Ozon商品发布、Ozon产品上传、查询Ozon上传结果、铺货、1688商品铺货等。

## 前置配置（必须先完成）

⚠️ **使用本 SKILL 前，必须先配置以下参数，否则铺货流程会失败。**

| 环境变量 | 说明 | 必填 | 获取方式 |
|---------|------|------|---------|
| `OZON_API_KEY` | Ozon 卖家后台的 API Key | ✅ 必填 | 在 [Ozon 卖家后台](https://seller.ozon.ru/) → API 设置中生成 |
| `OZON_CLIENT_ID` | Ozon 卖家后台的 Client ID | ✅ 必填 | 在 [Ozon 卖家后台](https://seller.ozon.ru/) → API 设置中查看 |
| `OZON_CURRENCY` | 货币代码，必须与 Ozon 个人中心设置的币种匹配 | ✅ 必填（默认 `RUB`） | `RUB`（卢布）或 `CNY`（人民币），货币不匹配会导致 API 报错 |
| `ALPHASHOP_ACCESS_KEY` | AlphaShop API Access Key（用于图片翻译） | ✅ 必填 | 可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可 |
| `ALPHASHOP_SECRET_KEY` | AlphaShop API Secret Key（用于图片翻译） | ✅ 必填 | 可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可 |

如果用户没有提供这些参数，**必须先询问用户获取后再继续操作**。

**⚠️ AlphaShop 接口欠费处理：** 如果调用 AlphaShop 接口时返回欠费/余额不足相关的错误，**必须立即中断当前流程**，提示用户前往 https://www.alphashop.cn/seller-center/home/api-list 购买积分后再继续操作。

### 配置方式

**Ozon 密钥配置文件位置**：`~/.openclaw/skillconfig/1688-Product-to-Ozon/ozon_config.json`
```json
{
  "OZON_API_KEY": "your-api-key",
  "OZON_CLIENT_ID": "your-client-id",
  "OZON_CURRENCY": "CNY"
}
```

**AlphaShop 密钥**在 OpenClaw config 中配置：
```json5
{
  skills: {
    entries: {
      "1688-Product-to-Ozon": {
        env: {
          ALPHASHOP_ACCESS_KEY: "YOUR_AK",
          ALPHASHOP_SECRET_KEY: "YOUR_SK"
        }
      }
    }
  }
}
```

## 核心功能

### 1. **1688到Ozon类目映射**
- 调用1688 OpenClaw API获取商品对应的Ozon类目
- 输入：1688商品类目ID，从结构信息中获取，优先取thirdCategoryId的值，如果没有，获取categoryId的值，传递的应当是类目的值！！是数字
- 输出：对应的Ozon类目信息

### 2. **获取Ozon类目属性要求**
- 查询Ozon API获取目标类目的所有属性要求
- 输入：Ozon类目ID（多个用逗号分隔）、用户认证信息（OZON_API_KEY、OZON_CLIENT_ID）
- 输出：属性列表和详细要求
- 注意：直接使用上一步骤中获取到的externalCategoryId，这个值一般有两个，由逗号分隔，不要只取其中一个作为类目ID

### 3 **查询字典属性的可选值（必须执行）**
- 在获取到类目属性列表后，对所有 `dictionary_id > 0` 的属性，必须先查询该属性的字典值列表
- **不要猜测或手写 dictionary_value_id**，必须通过脚本查询获取，否则会导致 `error_attribute_values_out_of_range` 错误

**工作流程：**
1. 先用 `queryOzonProperties.py` 获取属性列表
2. 筛选出所有 `dictionary_id > 0` 的属性
3. 对每个字典属性，用 `queryDictionaryValues.py` 查询可选值
4. 从返回结果中获取正确的 `id` 值（即 `dictionary_value_id`），填入商品数据

**使用 `queryDictionaryValues.py` 脚本查询字典值：**

```bash
# 搜索模式 - 根据关键词搜索匹配的字典值（推荐，更精准）
python queryDictionaryValues.py \
  --attribute_id 85 \
  --description_category_id 17028922 \
  --type_id 91565 \
  --search "Нет бренда"

# 列表模式 - 列出所有可选值（当不确定关键词时使用）
python queryDictionaryValues.py \
  --attribute_id 85 \
  --description_category_id 17028922 \
  --type_id 91565 \
  --limit 50
```

**参数说明：**
- `--attribute_id`: 属性ID（从 Step 2 获取的属性列表中取）
- `--description_category_id`: 描述类目ID（从类目映射结果中取）
- `--type_id`: 类型ID（从类目映射结果中取）
- `--search`: 搜索关键词（可选，用俄语，不传则列出所有值）
- `--limit`: 返回数量限制（默认50）

**输出格式：** JSON 数组，每个元素包含 `id`（即 dictionary_value_id）和 `value`

- 常见需要查询的属性：品牌(85/31)、类型(8229)、颜色(10096)、尺码(4295)、性别(9163)、材质、季节等

### 4. **商品数据结构转换**
- 这一步非常重要，要使用上述两部分能力产出的数据！！！
- 由AI大模型接收1688商品信息和Ozon属性要求
- 智能映射和转换商品属性
- 输入：Ozon的类目属性要求、1688的商品数据（JSON格式）、**Step 2.5查到的字典值**
- 输出：符合Ozon上架结构的商品结构（JSON格式）

#### Ozon的结构要求
这个是Ozon的结构实例，你需要按照这样的结构规范生成Ozon的商品数据，严格保持这个数据结构

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills