Skip to content

klisard/SKU-Image-Grabber

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SKU Image Grabber

A Chrome extension for e-commerce workers who manually source product images. Open product image tabs in Chrome, assign a SKU, and download everything — named and organised automatically.

Two versions live in this repo:

Folder Version Description
sku-grabber/ v1 Simple, single-product: grab image tabs, type a SKU, download or copy JSON.
sku-grabber-v2/ v2 Full-featured: multi-SKU sessions, tab groups, auto-detect SKU, format conversion, JSON/CSV export, save anywhere. Available on the Chrome Web Store.

The problem it solves

Finding product images manually means opening many tabs across different websites, copying URLs, building a JSON by hand, then running a downloader. This extension replaces that whole flow — you open the images, assign a SKU, and it handles the rest.


v1 — Simple grabber (sku-grabber/)

Install: chrome://extensions → Developer mode → Load unpacked → sku-grabber/

  1. Open the product's image tabs in Chrome
  2. Click the toolbar icon
  3. Type the SKU (e.g. LD01849)
  4. Click Download — files saved to Downloads/products/SKU/SKU (1).jpg etc. — or Copy JSON to use with an external downloader

v2 — Full-featured (sku-grabber-v2/)

Install (Chrome Web Store): Add to Chrome — one click, auto-updates.

Install (from source): chrome://extensions → Developer mode → Load unpacked → sku-grabber-v2/

Features (all toggleable in Settings)

  • Multi-SKU session — accumulate several products, then download/export all at once
  • Tab groups support — name a Chrome tab group with the SKU; the extension reads it automatically
  • Auto-detect SKU — from tab group name, a custom URL regex, or a page title/URL heuristic; always editable before saving
  • Format conversion — convert any image to JPG / PNG / WebP on the fly (off by default)
  • Save location — Downloads subfolder (fast) or any folder on disk via File System Access API
  • Export JSON or CSV — or both; JSON shape is compatible with v1

Workflow options

Quick (popup): open image tabs → click icon → confirm SKU → Download.

Multi-product (session page):

  • Add-to-session: add each product one by one, then open Session → Download all
  • Tab groups: put each product's image tabs in a named Chrome tab group, then Session → Import tab groups → Download all

Project structure

sku-grabber/          # v1 extension
sku-grabber-v2/       # v2 extension
  lib/                # shared modules (settings, session, sku, tabs, convert, download, fsa, export)
  popup.html/js       # quick capture popup
  session.html/js     # multi-SKU session manager
  options.html/js     # settings page
  styles.css          # shared dark theme

Platform limitations (browser-imposed)

  • Downloads mode can only write inside your Downloads folder. For an arbitrary path, use the Pick any folder mode (File System Access API).
  • Format conversion can only output JPG, PNG, or WebP — AVIF and GIF output are not supported by the browser canvas API.
  • After a browser restart, the File System Access folder permission may need re-granting — do this from the Session page (not the popup).