Pounding Ozon Probe

pounding-ozon-probe — 工具手册

1. 概述

pounding-ozon-probe 是跨境电商上架工具，覆盖从选品到上架 Ozon 的完整流程。

你的角色：操作员。你用以下命令完成工作。每条命令封装了完整的业务逻辑，你只需按场景选择并执行。

所有命令在 skill/ 目录下执行，使用 python3.12 scripts/cli.py。

2. 环境准备（首次使用）

2.1 安装依赖

cd skill && pip3.12 install -r requirements.txt

2.2 获取凭证

三个凭证一次性问完用户。MXOU_TOKEN 自动读到了就跳过。

python3.12 scripts/cli.py set_token --token <MXOU_TOKEN>
python3.12 scripts/cli.py set_ak --ak <1688_AK>
python3.12 scripts/cli.py set_store --name "主店铺" --client-id <CLIENT_ID> --api-key <API_KEY>

2.3 验证配置

python3.12 scripts/cli.py check

全部 ✅ 后方可执行业务操作。如有 ❌，按提示修复。

2.4 环境要求

• Python 3.12（必须）
• Google Chrome（工具自动启动，用户无需手动打开）

3. 意图路由

先判断用户意图，再选管线。每次操作前重新判断，不因上下文而惯性选择。

用户输入
  ├─ 有 1688 URL？              → 【管线 A】1688 直接上架
  ├─ 有 Ozon URL？              → 【管线 B】Ozon 跟卖
  ├─ "有什么好跟卖的"？无 URL    → 【管线 C】Ozon 中国站发现 → 跟卖
  └─ "帮我选品上架"？无 URL      → 【管线 D】1688 搜索/图搜 → 直接上架

关键规则：

• 有 URL = 直接处理该 URL，不去别的平台搜索
• 无 URL = 根据用户意图选管线 C 或 D
• 蓝海评分只在管线 C 中使用
• 管线 C（跟卖选品）和管线 D（选品上架）要区分："跟卖"→C，"上架"→D

4. 命令参考

管线 A：1688 上架

触发：用户消息含 1688.com 链接，或管线 B 降级

python3.12 scripts/cli.py graph --url "https://detail.1688.com/offer/xxx.html" --store "主店铺"

• 输入：1688 商品 URL、店铺名
• 输出：JSON {summary, envelope, submit_result}
  • summary：商品摘要（标题、价格、重量、尺寸、图片数、属性数、供应商）
  • envelope：完整的 GraphInput 信封（发给 Worker 的数据）
  • submit_result：Worker 提交结果（见 §5）
• 自动完成：CDP 抓取 1688 → 组装信封 → 提交 Worker

管线 B：Ozon 跟卖

触发：用户消息含 ozon.ru 链接

python3.12 scripts/cli.py follow --ozon-url "https://www.ozon.ru/product/xxx/" --store "主店铺" --auto-submit

• 输入：Ozon 商品 URL、店铺名
• 输出：JSON {summary, envelope, submit_result}
• 自动完成：CDP 抓取 Ozon → 图搜 1688 同款 → 组装信封 → 提交 Worker

降级：Ozon 页面禁止复制（DataDome 拦截）时：

1. 用 Ozon Widget API 获取产品信息
2. 用产品图片在 1688 图搜同款
3. 走管线 A（直接上架，不走跟卖）

管线 C：跟卖选品（Discover v2）

触发：用户说"有什么好产品可以跟卖"、"帮我找可以跟卖的"（无 URL）

# ① 有关键词：搜索 → 全量采集 → 表格展示 → 交互挑选 → 批量找货源
python3.12 scripts/cli.py discover --keyword "宠物用品"

# ② 无关键词：直接打开 Ozon 中国站（highlight 页）滚动懒加载采集
python3.12 scripts/cli.py discover --max-products 30

# ③ 自动筛选规则（跳过交互）：月销量≥200 且 广告占比≤30% 且 跟卖≤20
python3.12 scripts/cli.py discover --keyword "宠物用品" --rules "monthly_sales>=200,drr<=30,seller_count<=20"

# ④ 价格区间过滤（RUB）：区间外产品标记 ⏭️价区间外，不参与挑选/运营指标查询
python3.12 scripts/cli.py discover --keyword "收纳" --min-price 300 --max-price 2000

# ⑤ 指定页面 URL 直接采集（搜索页/类目页）
python3.12 scripts/cli.py discover --url "https://www.ozon.ru/search/?text=собака"

# ⑥ 挑选 + 货源后确认提交 Worker
python3.12 scripts/cli.py discover --keyword "宠物用品" --auto-submit

# ⑦ 不查 seller.ozon.ru 运营指标（未登录卖家后台时自动降级，无需手动加）
python3.12 scripts/cli.py discover --keyword "宠物用品" --no-analytics

• 输入：搜索关键词 或 Ozon 页面 URL 或 无（→ 中国站懒加载）
• 流程（v2，先采集后分析）：
  1. 采集：有 --keyword → 真实搜索页 /search/?text=；有 --url → 直接采集该页；都无 → 中国站 highlight 页滚动懒加载。结果容器限定（.tile-root），滚动到底部触发懒加载 + 等待渲染 + 翻页 + 去重
  2. 全量数据：widget API（价格/标题/图/品牌/评分/评论数）+ 跟卖数/最低价 + seller.ozon.ru 运营指标（月销量/增长率/广告占比/上架天数——需卖家后台已登录，未登录自动降级，表格运营列显示 —）
  3. 表格分析挑选：全量表格展示（含拒绝原因/状态）→ 人工按序号挑选 或 --rules 自动筛选 —— 此时不花 1688 配额
  4. 批量货源：只对选中的产品 1688 识图（CDP 图搜 → AK 图搜 → AK 关键词三级，含重试）→ 利润计算（真实重量/佣金）→ 蓝海评分 → 确认 → 提交
• 输出：候选产品列表（全量落盘 data/discovery/，CSV 可导出）
• 规则字段：monthly_sales / gmv / drr / seller_count / margin / price / create_days / sales_growth / rating
• 表格符号：✅可挑 待分析 · ⚠️夹带? 标题不含关键词 · ⏭️价区间外 超价格区间 · 💰有利 符合条件 · ⚠️利润低 利润不足 · ❌无货源 1688 没匹配到 · — 运营列无数据（卖家后台未登录）

展示候选列表后，等用户确认再提交。不替用户选择。

管线 D：选品上架

触发：用户说"帮我选品上架"、给关键词但没给 URL，意图是"上架"而非"跟卖"

子路径 D1：1688 图搜

python3.12 scripts/cli.py image_search --image "https://example.com/image.jpg"

• 输入：图片 URL 或本地路径
• 输出：JSON {success, results: [{offer_id, title, price, image, shop_name}]}

子路径 D2：Ozon 选品

python3.12 scripts/cli.py discover --keyword "宠物用品"
# 无关键词 → 直接采集中国站（highlight 页懒加载）
python3.12 scripts/cli.py discover --max-products 30

Discover v2 四阶段：采集（搜索/中国站懒加载）→ 全量数据（含运营指标）→ 表格挑选 → 批量 1688 货源 → 确认提交（详见管线 C）。

批量处理

python3.12 scripts/batch_test.py --urls-file urls.txt --submit

URL 文件混合 1688/Ozon 链接，自动识别管线。

5. Worker 响应处理

CLI 命令输出中的 submit_result 字段包含 Worker 的响应。按以下模板回复用户。

5.1 提交成功

Worker 返回：

{"ok": true, "task_id": "550e8400-...", "message": "Task submitted to queue"}

回复用户：

✅ 任务已提交到云端处理

• 任务 ID：{task_id}
• 预计耗时：10–20 分钟（类目匹配 → AI 生图 → Ozon 上架 → 审核）
• 流程完成后我会通知你。如有问题 Worker 会自动重试修复。

5.2 提交失败

5.3 查询进度

用户问"进度"、"完成了没"时：

• 任务提交后处于云端异步处理中，CLI 工具不提供实时进度查询
• 告知用户：任务正在云端处理中（类目匹配 → AI 生图 → Ozon 上传 → 审核），预计 10–20 分钟
• 不要频繁调用 Worker API 轮询状态

6. 决策边界

7. 错误处理

遇到任何错误，描述问题并引导用户修复。不自己修代码、不自己探索项目结构。

8. 常见越界行为

9. 参考文件

10. 更新与旧包升级

自动更新（v0.18.0 起，默认开启）：每次运行命令时，若 COS 上有新版本， 会自动备份旧文件 → 覆盖升级 → 失败自动回滚（data/ 凭证/登录态/缓存全程保留）， 升级成功后提示重启终端。

• 关闭自动更新：export SKILL_AUTO_UPDATE=0，退回「提示 + 手动 skill update」模式。
• 手动更新：python3.12 scripts/cli.py update

旧包升级（v0.12.0 之前的包没有 updater，不会自动提示）：

# 1. 从最新 GitHub Release 下载 bootstrap_update.py 到 skill 包目录
#    https://github.com/halojerry/ozon-worker/releases
# 2. 运行（会下载最新包 → sha256 校验 → 覆盖升级 → 失败回滚）
python3.12 bootstrap_update.py

如果运行 graph/follow 提示「未找到 scripts.cloud_probe（版本过旧）」， 按上面 bootstrap 升级即可。手动确认当前版本：python3.12 scripts/cli.py update （显示「已是最新」即正常）。