Etsy listing automation source package
Automate the Etsy listing workflow.
Manual Shop Manager work does not scale when you are testing categories, building product lines, and watching shop signals. This kit gives a buyer the source for Etsy listing automation: research inputs, analytics exports, asset upload, create/edit commands, and review gates before anything goes live.
- CLI surface
- 22 commands validate → analyze → upload → create → edit → guarded actions
- Test suite
- 94 passing 10 pytest modules, client through live pipeline
- Analytics areas
- 9 shop, stats, traffic, listing stats, ads, ads history, listings, facets, keywords
- Credentials shipped
- 0 auth is captured or imported by you, never bundled
- live-analyze shop · traffic · ads · keywords ✓ ready
- live-create upload images/files and create listing ✓ ready
- live-edit patch listing content and assets ✓ ready
What it lets a buyer build
The point is not a few example products. The point is a programmable Etsy operations layer a seller or builder can connect to their own product-generation, QA, analytics, and publishing workflow.
-
Research before creating listings
Pull shop summary, traffic, listing stats, ads, facets, and marketplace keyword signals into JSON or CSV. Use that data to choose categories, identify gaps, and decide which products deserve listing work.
-
Create and edit listings from structured inputs
Upload listing images, digital files, and video, prepare final listing payloads, create new listings, edit existing listings, and keep publishing behind explicit operator review.
-
Build an automated product workflow around it
A buyer can plug the CLI into their own upstream product creation, asset generation, copy QA, category selection, and reporting systems instead of operating Etsy one browser form at a time.
-
Keep control of live shop actions
Live create, edit, activate, deactivate, and delete actions are command surfaces with dry-run and confirmation paths, so the buyer can decide how much automation to allow.
What ships in the handoff
Everything ships under a perpetual source licence: the working code, the demo data, the docs, and the limitations notes. Read it, modify it, run it on your own machines. One price, no subscription, no seats, no hosted dependency. The licence covers your own business use — it does not permit reselling or hosting the code for others.
included
- digital_listing_cli.py main command entrypoint
- Live create/edit helpers and guarded listing actions
- Shop, listing, ads, traffic, facet, and keyword analyzer
- Category taxonomy search, attribute lookup, and local report tooling
- README, listing pipeline, and operator docs
components
- Listing automation CLI
- Prepare and validate payloads, then upload images, digital delivery files, and video. Create and edit listings behind a duplicate-title/SKU preflight, with recovery records for the non-idempotent create and an image sync that never drops your buyer delivery file. Auth refreshes headlessly; every live action has dry-run and confirmation gates.
- Market and shop analyzer
- Collects shop summary, stats, traffic details, listing stats, ads, listings, facets, and optional marketplace keyword output as JSON or CSV.
- Automation foundation
- README, listing pipeline, agent orchestration guide, endpoint registry, category cache, tests, and artifact rules for wiring the CLI into a buyer-controlled workflow.
How intent becomes output
The operator path, start to finish. Each step is a real command surface, not a promise.
- 01
Research
Collect marketplace, shop, traffic, listing, ads, and keyword signals before deciding what to list next.
- 02
Prepare
Generate structured listing inputs with titles, tags, taxonomy, pricing, images, delivery files, and policy checks.
- 03
Create/Edit
Capture Etsy auth manually, upload images/files, and create or update listings through the seller session.
- 04
Control
Use dry-run, review, publish, activate, deactivate, and delete commands with explicit operator decisions.
What's proven, what's excluded
The same diligence a technical buyer would run: what the code demonstrates locally, and what is deliberately left out of a clean handoff.
✓ proven
-
Live command surface exists
The CLI includes live summary, live analyze, live create, live edit, category taxonomy lookup, pending-create recovery, and guarded listing actions for shops the buyer is authorized to operate, backed by 94 passing tests across 10 pytest modules covering the client, analyzer, live pipeline, category attributes, and validation.
-
Review gates exist
Publishing and destructive listing actions stay behind explicit operator choices, with dry-run and confirmation paths for safer workflow design.
-
Guardrail docs
The README says to stop on auth failures, CAPTCHA, login challenges, rate limits, unexpected HTML, or Etsy protection responses.
! excluded
-
No private auth shipped
No cookies, CSRF values, browser profiles, HAR files, credentials, shop identifiers, or live-result artifacts should ship in a clean buyer package.
-
Private endpoint risk
Live commands replay your own logged-in session against Etsy’s private (unofficial) AJAX endpoints, and the HTTP client matches a real Chrome TLS/HTTP2 fingerprint so a captured session replays cleanly. This is not the sanctioned Etsy API and can violate Etsy’s Terms; used carelessly or at scale it risks account suspension. Run only on a shop you own, at human pace, and get your own legal review before commercial use.
-
Seller responsibility
Use only on a shop you own or are authorized to operate, and review every listing manually before publishing.
-
What the licence grants
A perpetual, non-transferable licence for one business to run and modify the source internally — no seats, no subscription. It does not transfer ownership of the code, and it does not permit reselling, redistributing, hosting it as a service or API, or white-labelling it. The delivered LICENSE.md governs.
Build it yourself, or start from the source
Request handoff
Build the automation layer behind an Etsy catalog.
Reply and we’ll send the full file tree, the test suite, a redacted analyzer export, and the exact ToS/risk boundaries — so you can evaluate the source before you commit $699.
Request handoffOpens your mail client. If it doesn't, write to [email protected] and mention the etsy operations kit.