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

2. 打开浏览器

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

3. 获取页面快照

   browser snapshot
   

4. 提取图片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 结尾

5. 创建保存目录

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

6. 下载图片

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

7. 报告结果

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

注意事项

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