# 1688 Product To Ozon

将1688的商品铺货到俄罗斯电商平台Ozon（上架），通过Ozon官方API实现商品信息的上传和状态查询。适用于需要将单个1688的商品上架到Ozon的场景。

- Repository: https://github.com/LeoYeAI/agent-master-skills (2171 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add LeoYeAI/agent-master-skills --skill 1688-Product-to-Ozon -g -a claude-code -y`
Codex: `npx skills add LeoYeAI/agent-master-skills --skill 1688-Product-to-Ozon -g -a codex -y`
Cursor: `npx skills add LeoYeAI/agent-master-skills --skill 1688-Product-to-Ozon -g -a cursor -y`
Gemini CLI: `npx skills add LeoYeAI/agent-master-skills --skill 1688-Product-to-Ozon -g -a gemini-cli -y`

## Description

将1688的商品铺货到俄罗斯电商平台Ozon（上架），通过Ozon官方API实现商品信息的上传和状态查询。适用于需要将单个1688的商品上架到Ozon的场景。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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类目信息

The rest: https://github.com/LeoYeAI/agent-master-skills/blob/HEAD/skills/1688-product-to-ozon/SKILL.md