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 前，必须先配置以下参数，否则铺货流程会失败。

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

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

配置方式

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

AlphaShop 密钥在 OpenClaw config 中配置：
json5
{
skills: {
entries: {
1688-Product-to-Ozon: {
env: {
ALPHASHOPACCESSKEY: YOUR_AK,
ALPHASHOPSECRETKEY: YOUR_SK
}
}
}
}
}

核心功能

1. 1688到Ozon类目映射

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

2. 获取Ozon类目属性要求

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

3. 查询字典属性的可选值（必须执行）

• - 在获取到类目属性列表后，对所有 dictionaryid > 0 的属性，必须先查询该属性的字典值列表
• 不要猜测或手写 dictionaryvalueid，必须通过脚本查询获取，否则会导致 errorattributevaluesoutofrange 错误

工作流程：

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

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

bash

搜索模式 - 根据关键词搜索匹配的字典值（推荐，更精准）

列表模式 - 列出所有可选值（当不确定关键词时使用）

参数说明：

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

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

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

4. 商品数据结构转换

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

Ozon的结构要求

{
items: [
{
attributes: [
{
complex_id: 0,
id: 5076,
values: [
{
dictionaryvalueid: 971082156,
value: 麦克风架
}
]
},
{
complex_id: 0,
id: 9048,
values: [
{
value: 一套X3NFC保护膜。 深色棉质
}
]
},
{
complex_id: 0,
id: 8229,
values: [
{
dictionaryvalueid: 95911,
value: 一套X3NFC保护膜。深色棉质
}
]
},
{
complex_id: 0,
id: 85,
values: [
{
dictionaryvalueid: 5060050,
value: Samsung
}
]
},
{
complex_id: 0,
id: 10096,
values: [
{
dictionaryvalueid: 61576,
value: 灰色的
}
]
}
],
barcode: 112772873170,
descriptioncategoryid: 17028922,
newdescriptioncategory_id: 0,
color_image: ,
complex_attributes: [],
currency_code: RUB,
depth: 10,
dimension_unit: mm,
height: 250,
images: [
https://example.com/translatedimage2.jpg,
https://example.com/translatedimage3.jpg,
https://example.com/translatedimage4.jpg
],
images360: [],
name: 一套X3NFC的保护