1688（1688 搜索）

淘宝/1688 商品图片下载器

从淘宝、1688等电商平台下载商品图片到本地。

工作流程

方式一：通过商品URL下载

1. 用户提供商品页面URL
2. 使用浏览器打开页面
3. 快照获取页面内容
4. 提取图片URL
5. 下载保存

方式二：通过商品名搜索下载

1. 用户提供商品名称
2. 使用浏览器搜索淘宝/1688
3. 找到目标商品
4. 进入商品详情页
5. 提取并下载图片

使用方法

下载脚本

脚本位置: scripts/download_images.py

# 直接下载图片URL列表
python scripts/download_images.py --images /tmp/image_urls.txt --output ./商品图片

# 使用配置文件
python scripts/download_images.py --config /tmp/download_config.json

浏览器操作（推荐）

由于淘宝/1688有反爬机制，必须使用浏览器来访问和获取图片：

// 使用 browser 工具打开商品页面
browser open --url "商品URL" --profile openclaw

// 获取页面快照，提取图片URL
browser snapshot

// 从快照中识别图片元素，提取src或data-src

图片保存位置

• 默认保存到: ~/.openclaw/sharespace/商品图片/{商品名}/
• 主图命名: main_01.jpg, main_02.jpg, ...
• 详情图命名: detail_01.jpg, detail_02.jpg, ...

执行步骤

当用户请求下载商品图片时：

1. 确认信息

- 商品URL 或 商品名称 - 是否需要详情图（默认只下载主图） - 保存目录（默认共享文件夹）

1. 打开浏览器

   browser open --url "<商品URL>" --profile openclaw

1. 获取页面快照

   browser snapshot

1. 提取图片URL（关键步骤）

1688的图片URL格式： - 主图: https://cbu01.alicdn.com/img/ibank/O1CN01xxxxx_!!店铺ID-0-cib.jpg - 颜色图: 同上，在颜色选择区域 - 详情图: 需要从页面script标签或data-src中提取

正确提取方法：

   // 1. 获取所有img标签的src
   document.querySelectorAll('img').forEach(img => {
     const src = img.src;
     if (src.includes('cbu01.alicdn.com/img/ibank')) {
       images.push(src);
     }
   });
   
   // 2. 从script标签提取详情图（重要！）
   document.querySelectorAll('script').forEach(script => {
     const text = script.textContent;
     const matches = text.match(/https?:\/\/cbu01\.alicdn\.com\/img\/ibank[^"'\s]+/g);
     if (matches) detailImages.push(...matches);
   });

URL处理： - 去掉 .webp 后缀获取原图 - 去掉 220x220.jpg、250x250.jpg、310x310.jpg 等缩略图后缀 - 详情图URL通常以 !!3827449935-0-cib.jpg 结尾

1. 创建保存目录

   mkdir -p ~/.openclaw/sharespace/商品图片/{商品名}/{主图,颜色图,详情图}

1. 下载图片

- 使用 requests 下载，设置 Referer 头 - 主图命名: main_01.jpg, main_02.jpg, ... - 颜色图命名: color_01.jpg, color_02.jpg, ... - 详情图命名: detail_01.jpg, detail_02.jpg, ...

1. 报告结果

- 下载成功数量 - 每张图片的文件大小 - 保存路径 - 失败的图片（如有）

注意事项

• 淘宝/1688 需要登录才能查看部分内容
• 图片URL可能带有防盗链，需要设置 Referer
• 部分图片是懒加载，需要滚动触发
• 主图通常是 800x800 或更大的正方形图
• 详情图可能是长图，需要特别处理

示例对话

用户: 帮我下载这个商品的图片 https://detail.1688.com/offer/123456.html

Agent:

1. 打开浏览器访问该URL
2. 获取页面快照
3. 提取图片URL（找到5张主图，12张详情图）
4. 创建目录并下载
5. 报告: 已保存到 ~/.openclaw/sharespace/商品图片/商品名/

用户: 帮我在淘宝搜"无线蓝牙耳机"下载主图

Agent:

1. 打开淘宝搜索页面
2. 搜索"无线蓝牙耳机"
3. 从搜索结果提取商品主图
4. 下载保存