Gumroad Image Uploader

Automates bulk updates of product cover images and thumbnails across your Gumroad catalog using a CSV manifest or structured image folder.

Install
cmdop skills install agensi-gumroad-image-uploader

Gumroad Image Uploader is a skill that automates bulk replacement of product cover images and thumbnails across a Gumroad catalog. Instead of navigating the Gumroad web dashboard for each product individually, an agent can drive updates through a CSV manifest that maps local image files to products via their custom permalinks, or by pointing to a structured local image folder.

Before any API call is made, the skill runs pre-flight checks: it validates the access token, inspects each image file for corruption using Pillow, and warns about files that fall outside Gumroad’s size requirements. This reduces failed uploads and wasted API calls on malformed assets.

The skill handles the multipart form-data encoding that Gumroad’s API requires for file uploads, and it manages edge cases such as API rate limits and missing products gracefully rather than failing silently or crashing mid-batch. Supported image formats are JPG, PNG, and WebP.

The execution environment is Python-based and relies on Gumroad API v2. There are no environment variables listed in the registry record, so access token configuration will need to be confirmed from the skill’s own documentation at runtime.

This skill is appropriate when a seller has a large Gumroad catalog and needs to refresh cover art in bulk. It is not a general-purpose Gumroad management tool — it covers image assets only and does not handle product creation, pricing, file delivery, or other catalog operations.

Use cases

  • Bulk-replace cover images across an entire Gumroad catalog using a CSV file that maps permalinks to local image paths
  • Run pre-flight image validation to catch corrupt files or oversized assets before hitting the Gumroad API
  • Update product thumbnails from a structured local folder without manually logging into the Gumroad dashboard
  • Handle API rate limiting automatically when pushing image updates across a large number of products
  • Detect and report missing Gumroad products during a batch run instead of failing silently

When to use it

  • Updating cover images or thumbnails for many Gumroad products at once
  • Automating a periodic refresh of product artwork as part of a larger publishing pipeline
  • Validating local image assets against Gumroad requirements before upload
  • Mapping a local folder of renamed image files to remote products via custom permalinks

When not to use it

  • Managing Gumroad product metadata, pricing, or digital file delivery — this skill covers images only
  • Creating new Gumroad products from scratch
  • Working with image hosting platforms other than Gumroad
  • Scenarios where no Python execution environment is available