Ozon 零依赖上架工具箱
Overview
把商品（淘宝/天猫采集、1688 链接、Ozon 商品页选品、或 CSV/JSON）直接调 Ozon Seller API 上架，不依赖任何完整 ERP、不接任何第三方付费服务、数据不出本机。
- 零外部依赖：核心上架仅用 Python 标准库；图片处理可选 Pillow；翻译可选 DeepSeek/MyMemory（免费回退）。
- 多源采集：淘宝/天猫、1688、Ozon 商品页（含中国馆选品雷达）。
- 专业定价：D3 反推公式，利润率强制 ≥30%，而非简单乘系数。
- 真实跑通：已通过 CSV 批量上架跑通完整链路（product_id 6192230298），含图片 ImgBB 转存与类目专属属性兜底。
与官方 ozon-1688-uploader 的差异（为什么用这个）
| 维度 | 官方 ozon-1688-uploader | 本工具 |
|---|---|---|
| 外部付费依赖 | 必须 AlphaShop（图片翻译，欠费即中断）+ 1688 OpenClaw 类目 API | 零第三方付费服务，纯本地 |
| 采集源 | 仅 1688 | 淘宝/天猫/1688/Ozon 中国馆 |
| 图片处理 | 调 AlphaShop 翻译图内文字（付费） | 本地 Pillow 去背景+俄文水印（免费） |
| 定价 | 1688 价 ×3（无利润率控制） | D3 公式，利润率≥30% 强制 |
| 数据流向 | 经第三方服务 | 本机 → Ozon API 直连 |
适合：不想被第三方服务绑死、要掌控成本与数据、做中国馆选品雷达、需要专业利润核算的卖家。
三种上架路径
路径 A：淘宝/天猫采集 → 上架
- 浏览器装
scripts/taobao_collector.user.js（Tampermonkey）。 - 打开淘宝/天猫商品页 → 浮层自动抓取 → 填类目ID/类型ID/尺寸/成本运费贴单退货率/利润率(≥30%) → 「🚀 一键上架」。
- 脚本把数据 POST 到本地中继
scripts/relay_server.py(:8011) → 调 Ozon 完成上架。
- 淘宝页价 = 进货成本参考，可直接进 D3 公式。
路径 B：Ozon 商品页（中国馆）选品 → 上架
- 浏览器装
scripts/ozon_collector.user.js。 - 打开 Ozon 任意商品页（含中国馆）→ 浮层抓取标题/卢布售价/类目面包屑/属性/评价。
- 关键约束：Ozon 页价是卢布零售价≠你的成本（成本独立手填）；Ozon 图有防盗链+侵权风险，默认不放图，需自备货源图。中国馆定位=爆款雷达，发现什么在卖/什么价/什么类目，再自己找货源上架，不要直接复制对手 Listing。
- 填类目ID/类型ID/尺寸/成本等 → 「🚀 一键上架」。
路径 C：CSV/JSON 直接上架
- 准备清单（字段见下），密钥写入
scripts/ozon_config.json。 - 运行
python scripts/ozon_lister.py --input products.csv --imgbb-key <key> --wait - 或启中继
python scripts/relay_server.py后由油猴触发。
前置配置（所有路径共用）
在 scripts/ 同目录建 ozon_config.json（勿提交密钥）：
{
"client_id": "你的Client-Id",
"api_key": "你的Api-Key",
"imgbb_key": "ImgBB图床key(可选)",
"translate_key": "DeepSeek key(可选, 无则回退MyMemory)",
"translate_mode": "auto"
}
或设环境变量 OZON_CLIENT_ID / OZON_API_KEY / IMGIBB_KEY。密钥也可从 MySQL stores 表的 Client-Id / Api-Key 字段获取。
商品字段约定（CSV 表头 / 油猴导出 / 中继 row 通用）
供货id, 商品标题, 售价, 原价, 类目id, 类型id, 宽, 高, 长, 重量, 图片, 品牌, 型号, 属性, 描述, 主题标签
（中/俄/英别名均可，ozon_lister.build_header_map 自动归一化。）
类目匹配
油猴浮层抓取商品页俄文/中文面包屑，自动调本地中继 /match-category 精确匹配 Ozon 类目树，输出 description_category_id / type_id 并回填；匹配不到时由人工确认补充。
关键约束与踩坑
详见 references/pitfalls.md（Ozon v3 载荷结构、中译俄西里尔跳过、D3 公式、图片防盗链、PNA/CORS、采集脚本差异等）。最易错三点：
- 价格必须整数字符串；vat:"0"；depth←界面"长"。
- 俄文标题/描述由 translate_text 自动跳过翻译（含西里尔即返回原文）。
- 不要直接抄 Ozon 原图（防盗链+侵权）；图片直链优先 ImgBB 转存。
Resources
scripts/ozon_lister.py— 核心上架（归一化→构建→预检→转图床→提交→轮询），CLI 与中继共用run_pipeline。scripts/relay_server.py— 本地中继 :8011，解决浏览器 CORS/PNA。scripts/taobao_collector.user.js— 淘宝/天猫采集油猴。scripts/ozon_collector.user.js— Ozon 商品页（含中国馆）采集油猴。references/pitfalls.md— 详细踩坑与关键事实。README.md— 面向用户的使用说明与竞品对比。
