Seller Tools • Listing Workflow
BewitcheryUK Seller Tools is a private, self-hosted listing workflow application built for a small UK-based seller of vintage and collectible items. It streamlines the process of preparing, scheduling, and publishing marketplace listings across eBay and Etsy, with optional cross-posting to Instagram and Facebook.
Instead of filling in marketplace forms manually, the seller sends precise item details via a web chat or a private Telegram bot (an agent-style guided workflow). The system organises the information into structured listing fields and templates. The seller reviews, edits, and explicitly approves every listing before it is published.
The seller sends product photos through the web dashboard or Telegram. Photos are stored on the self-hosted server and attached to a draft listing.
The seller enters precise details using guided prompts (condition, size, materials, provenance, SKU, notes). The workflow ensures required fields are captured.
The application formats the seller’s input into structured listing sections using templates and rules (title format, description blocks, attributes, and standard shop policies).
The seller reviews the draft and edits anything as needed. Only when the seller explicitly approves is the listing prepared for publication. Nothing is auto-published.
The approved listing is published immediately or scheduled for a future date. The marketplace API (eBay or Etsy) is called to create the listing with photos, description, price, and shipping.
The application uses the Etsy Open API v3 for listing operations. All API calls are initiated by the seller through explicit actions. The tool is private and used by a single seller only.
| Endpoint | Purpose | When Called |
|---|---|---|
POST /shops/{id}/listings |
Create a new draft listing with seller-provided title, description, price, and taxonomy | When the seller approves a draft for creation |
POST /listings/{id}/images |
Upload product photos to the listing | After draft listing creation |
PUT /listings/{id} |
Update listing details or state (draft to active) | When the seller confirms go-live |
GET /shops/{id}/listings |
Retrieve existing listings for the seller's shop | When viewing the dashboard |
GET /shops/{id}/shipping-profiles |
Fetch available shipping profiles for new listings | During listing preparation |
GET /seller-taxonomy/nodes |
Retrieve Etsy category taxonomy for categorisation | During listing preparation |
DELETE /listings/{id} |
Remove a listing if the seller cancels before publication | Seller-initiated deletion only |
Self-hosted Node.js server running on the seller's own machine. No cloud database, no third-party storage. All data stays local.
BewitcheryUK is an established UK-based seller specialising in vintage and collectible items. The shop has a long-running eBay presence with positive feedback and an active Instagram following. This tool was built in-house to reduce the manual effort of listing items across multiple platforms while maintaining consistent, accurate listing information.