亚马逊智能采集器 (Browser Extension)

Chrome 浏览器扩展，用于在亚马逊页面自动采集 ASIN 并上传至后端 API。

版本信息

功能特性

🌍 站点快捷访问 (v2.1.0 新增)

✅ 自动 ASIN 采集

✅ 智能分页

✅ 数据上传

✅ 用户友好

安装指南

1. 加载扩展到 Chrome

  1. 打开 Chrome 浏览器
  2. 访问 chrome://extensions/
  3. 启用右上角的"开发者模式"
  4. 点击"加载已解压的扩展程序"
  5. 选择 browser-extension-asin-scraper 目录
  6. 扩展将出现在工具栏中

2. 配置 API 端点

  1. 点击扩展图标
  2. 在"API 地址"输入框中输入后端 API 地址
  3. 点击"保存配置"按钮

使用方法

基本使用流程

  1. 快速访问亚马逊站点 (v2.1.0 新功能 🌍)

  2. 打开亚马逊搜索页面

  3. 启动扩展

  4. 开始采集

  5. 查看结果

高级功能

暂停采集

取消采集

重置状态

快速测试

方法 1: 使用测试脚本

Windows (PowerShell):

cd browser-extension-asin-scraper
.\test-api.ps1

Linux/Mac (Bash):

cd browser-extension-asin-scraper
chmod +x test-api.sh
./test-api.sh

方法 2: 手动测试

# 测试健康检查
curl https://njdk.xyz:18012/health

# 测试 API 上传
curl -X POST https://njdk.xyz:18012/api/upload-asins \
  -H "Content-Type: application/json" \
  -d '{
    "asinList": ["B08N5WRWNW"],
    "site": "US",
    "source": "test"
  }'

故障排查

如果遇到问题，请参考 故障排查指南

常见问题快速参考

❌ ERR_BLOCKED_BY_CLIENT

❌ runtime.lastError

❌ Failed to fetch

技术架构

扩展组件

browser-extension-asin-scraper/
├── manifest.json              # 扩展配置
├── src/
│   ├── background/
│   │   └── service-worker.js  # 后台服务（API 调用）
│   ├── content/
│   │   └── content-script.js  # 内容脚本（ASIN 提取）
│   ├── popup/
│   │   ├── popup.html         # 弹出窗口界面
│   │   ├── popup.js           # 弹出窗口逻辑
│   │   └── popup.css          # 样式
│   └── utils/
│       └── constants.js       # 常量配置
├── icons/                     # 扩展图标
├── test-api.sh                # Linux/Mac 测试脚本
├── test-api.ps1               # Windows 测试脚本
├── TROUBLESHOOTING.md         # 故障排查指南
└── README.md                  # 本文件

数据流程

Amazon 页面
    ↓ (content-script.js 提取 ASIN)
Content Script
    ↓ (chrome.runtime.sendMessage)
Background Service Worker
    ↓ (fetch API)
Backend API (https://njdk.xyz:18012)
    ↓
PostgreSQL 数据库

消息类型

消息类型 发送者 接收者 用途
START_SCRAPING Popup Content Script 开始采集
SCRAPING_PROGRESS Content Script Background 更新进度
SCRAPING_COMPLETE Content Script Background 采集完成
SCRAPING_CANCELLED Content Script Background 采集取消
UPLOAD_COMPLETE Background Popup 上传成功
UPLOAD_ERROR Background Popup 上传失败
GET_PAGE_INFO Popup Content Script 获取页面信息

开发指南

本地开发

  1. 修改代码

    cd browser-extension-asin-scraper/src
# 编辑文件

  2. 重新加载扩展

  3. 调试

版本发布

  1. 更新版本号

    // manifest.json
{
  "version": "2.0.3"
}

  2. 测试功能

    ./test-api.ps1  # Windows
./test-api.sh   # Linux/Mac

  3. 打包扩展

API 规范

上传 ASIN 端点

请求:

POST https://njdk.xyz:18012/api/upload-asins
Content-Type: application/json

{
  "asinList": ["B08N5WRWNW", "B08N5KWB9H"],
  "timestamp": "2024-01-01T00:00:00.000Z",
  "source": "amazon-asin-scraper",
  "version": "2.0.2",
  "site": "US",
  "marketplace": "ATVPDKIKX0DER",
  "url": "https://www.amazon.com/s?k=laptop",
  "category": "Electronics",
  "categoryId": "172282",
  "searchKeyword": "laptop",
  "totalResults": "50000",
  "sellerId": null,
  "sellerName": null,
  "collectionStats": {
    "totalAsins": 2,
    "collectedAt": "2024-01-01T00:00:00.000Z"
  }
}

响应:

{
  "success": true,
  "message": "ASIN data uploaded successfully",
  "count": 2,
  "uploadedAt": "2024-01-01T00:00:00.000Z",
  "metadata": {
    "site": "US",
    "category": "Electronics",
    "searchKeyword": "laptop",
    "totalResults": "50000"
  }
}

安全性

权限说明

数据隐私

性能优化

兼容性

更新日志

v2.1.0 (2025-10-21) - 站点快捷访问增强版 🎉

✨ 新增功能

🎨 UI/UX 优化

🔧 技术改进

v2.0.3 (2024年更新)

v2.0.2 (2024-01-21)

v2.0.1

贡献指南

欢迎提交 Issue 和 Pull Request！

报告 Bug

请提供以下信息：

  1. 扩展版本号
  2. 浏览器版本
  3. 错误截图
  4. 控制台日志
  5. 复现步骤

功能建议

请描述：

  1. 功能需求
  2. 使用场景
  3. 预期行为

许可证

MIT License

相关链接

支持

如有问题，请参考：

  1. 故障排查指南
  2. 运行测试脚本：test-api.ps1 或 test-api.sh
  3. 查看浏览器控制台日志
  4. 提交 GitHub Issue

Happy Scraping! 🚀