How oguzhankayan/etsy-engine works
etsy-engine discovers Etsy product opportunities, validates demand and risk, designs printable or optional Canva products, generates and quality-checks assets, creates listing imagery and SEO, then prepares Etsy drafts. Its SQLite database preserves pipeline state and supports a post-publication learning loop. The README documents the major stages and optional Canva line; sampled source excerpts provide additional evidence for generation and storage behavior, while unsampled modules are represented only where documented.
Main entry points: pipeline.py Discovery pipeline · generator.py Page generation and QC · image_client.py Image client · scoring Scoring and gates
Components 20
Opportunity discovery
- Trend sources
src/etsy_engine/sources - Product ideas
src/etsy_engine/product_ideas.py - Discovery pipeline
src/etsy_engine/pipeline.py - Scoring and gates
src/etsy_engine/scoring - Etsy market research
src/etsy_engine/scoring/etsy_market.py
Product production
- Bundle architect
src/etsy_engine/product/architect.py - Art direction
src/etsy_engine/design/art_director.py - Page generation and QC
src/etsy_engine/generate/generator.py - Image client
src/etsy_engine/generate/image_client.py
Listing and publishing
- Listing mockups
src/etsy_engine/mockups/generator.py - SEO listing copy
src/etsy_engine/seo/writer.py - Draft publisher
src/etsy_engine/publish/publisher.py
State and learning
- SQLite product memory
src/etsy_engine/db.py - Metrics and learning
src/etsy_engine/learning
Canva product line
- Canva production
src/etsy_engine/canva/produce.py
Other components
- Shop operator
- Command interface
src/etsy_engine/__main__.py - Raywake image service
- Etsy service
- Anthropic models
Connections 24
- Shop operator → Command interface: runs commands
README.md - Command interface → Discovery pipeline: starts stages
README.md - Discovery pipeline → Trend sources: collects trends
README.md - Discovery pipeline → Product ideas: includes ideas
src/etsy_engine/pipeline.py - Discovery pipeline → Scoring and gates: scores candidates
README.md - Discovery pipeline → Etsy market research: validates demand
src/etsy_engine/pipeline.py - Discovery pipeline → Bundle architect: plans bundles
README.md - Bundle architect → Etsy market research: reads market data
src/etsy_engine/product/architect.py - Discovery pipeline → Page generation and QC: generates pages
README.md - Page generation and QC → Art direction: uses art direction
src/etsy_engine/generate/generator.py - Page generation and QC → Image client: requests images
src/etsy_engine/generate/generator.py - Image client → Raywake image service: selects engine
src/etsy_engine/generate/image_client.py - Discovery pipeline → Listing mockups: creates mockups
README.md - Listing mockups → Image client: generates scenes
src/etsy_engine/mockups/generator.py - Discovery pipeline → SEO listing copy: writes listing copy
README.md - Discovery pipeline → Draft publisher: prepares drafts
README.md - Draft publisher → Etsy service: creates drafts
- Discovery pipeline → SQLite product memory: persists stages
src/etsy_engine/pipeline.py - Metrics and learning → SQLite product memory: reads metrics
README.md - Shop operator → Canva production: prepares templates
README.md - Canva production → Raywake image service: generates imagery
- Scoring and gates → Anthropic models: analyzes candidates
README.md - SEO listing copy → Anthropic models: drafts copy
README.md - Page generation and QC → Anthropic models: checks page quality
README.md