Public on GitHub · Built with Claude

Handmade goods, and the
AI that lists them.

CloudNine Home Essentials runs handmade jewelry and candle shops on Etsy. To keep up with our own catalog, we built Etsy Listing Agent: a multi-agent system that turns a few raw product photos into a complete, reviewed listing.

etsy-listing-agent · run
UnderstandPlanGenerateDeliver
L1 SchemaL2 RulesL3 Claude
Illustrative run, not live output
What we do

One company, two crafts.

We sell handmade jewelry and candles, and we build the software that gets them in front of buyers. The shops are the agent's first and toughest customer.

4pipeline phases, from photos to listing
10planned image slots per product
3review layers on every output
160+automated tests across engine and backend
Etsy Listing Agent

From raw photos to a finished listing.

Give it a few product photos and basic product info. The agent works through four phases, fanning out into parallel tasks and retrying anything that fails review.

01

Understand

Reads the product photos and data, and builds a structured picture of the piece: materials, shape, color, scale.

Claude vision
02

Plan

Designs a photography strategy across 10 image slots, from hero shot to detail, scale, and lifestyle scenes.

10 image slots
03

Generate

Runs 10 image-prompt tasks and the listing copy in parallel, then gathers the results into one package.

11 parallel tasks
04

Deliver

Produces the images, reviews the full listing, and automatically retries anything that falls short.

Auto-retry on failure
Quality gate

Nothing ships without passing three layers of review.

Generated content is only useful if you can trust it. Every output is checked for structure, then for marketplace rules, then read by Claude for meaning: does this description match the actual product in the photos?

L1
SchemaIs the output complete and well-formed?
pass
L2
Business rulesDoes it follow listing and category requirements?
pass
L3
Semantic review with ClaudeIs it accurate, on-brand, and true to the product?
pass

Built with Claude

Claude's vision reads the product photos, and Claude performs the final semantic review. Agents run multi-turn tool-use loops on the Anthropic Messages API.

Orchestration

LangGraph coordinates the workflow, with parallel fan-out, automatic retries, and live progress streamed to the dashboard.

Full application

A FastAPI backend and a Next.js dashboard, with sign-in, job history, and observability built in.

Read the code on GitHub ↗ github.com/Brucegx/etsy-listing-agent
Our shops

Made by hand, listed by agent.

Four brands, one pipeline. Our shops are where the agent earns its keep, tested against real products and real buyers.

About

Listing a product well takes hours. We built an agent to give those hours back to the craft.

Research the keywords, plan the photos, write copy that is accurate and findable. Multiply that by a growing catalog and listing becomes the bottleneck of the whole business.

We built Etsy Listing Agent to remove that bottleneck for ourselves, and we develop it in the open. It runs on our own shops first, so every improvement is tested against real products and real buyers.

Get in touch

hello@cloudninehomeessentials.com

Questions about the agent, the shops, or working together? We read everything.