淘宝/1688 商品图片下载器#

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

工作流程#

方式一：通过商品URL下载#

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

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

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

使用方法#

下载脚本#

脚本位置: scripts/download_images.py

bash

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

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

浏览器操作（推荐）#

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

javascript

// 使用 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 或 商品名称
   • 是否需要详情图（默认只下载主图）
   • 保存目录（默认共享文件夹）

2. 打开浏览器 text

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

3. 获取页面快照 text

   browser snapshot
   
   

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

   1688的图片URL格式：

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

正确提取方法： javascript

// 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. 创建保存目录 bash

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

2. 下载图片

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

3. 报告结果

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

注意事项#

• 淘宝/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. 下载保存