How I Built an AI Amazon Listing Generator with Compliance Scoring in 30 Seconds

#ai #ecommerce #amazon #webdev

How I Built an AI Amazon Listing Generator with Compliance Scoring in 30 Seconds

Writing product listings for Amazon is deceptively hard. You're not just writing copy — you're navigating a maze of policy rules: title length limits, banned promotional words, character constraints per bullet, and marketplace-specific quirks.

I spent weeks watching sellers (including myself) burn hours on listings that got rejected or underperformed. So I built an AI listing generator that bakes compliance checks into the generation itself, not as an afterthought.

Here's how it works under the hood.

The Core Problem

A "good" Amazon listing isn't just persuasive. It has to be:

Compliant — titles ≤ 75 characters (the new Amazon rule), no promotional phrases ("best", "cheap", "100% quality"), no ALL-CAPS abuse
Structured — title + 5 bullet points + description
Scored — so the seller knows quality before publishing

Generic AI writers handle #1's creativity but ignore #2 and #3 entirely. That's the gap.

Architecture: Compliance-First Prompting

Instead of generating free-form text and validating later, I inject the rules into the prompt and then run a deterministic scoring pass on the output. (The prompt below is simplified — the real one is parameterized per product.)

[SYSTEM]
You are an Amazon listing expert. Rules:
- Title MUST be ≤ 75 characters
- No promotional words: best, cheapest, premium (unless brand)
- No ALL-CAPS words
- Exactly 5 bullet points, each ≤ 20 words
- Include: product name, key feature, material, use case, benefit

[USER]
Product: Portable Blender
Category: Kitchen & Dining
Features: 300ml, USB-C rechargeable, 6 blades, travel-friendly
Target market: US

The model returns a structured listing. Then a scoring function evaluates it:

function scoreListing(listing) {
  let score = 100;
  const title = listing.title || '';
  if (title.length > 75) score -= 30;                    // hard compliance
  if (title.length < 30) score -= 10;                    // too short to rank
  if (keywordDensity(title) > 0.25) score -= 15;         // stuffing risk
  if (uppercaseRatio(title) > 0.85) score -= 10;         // ALL-CAPS abuse
  if (listing.bullets.length < 5) score -= 10;
  if (listing.bullets.some(b => b.split(/\s+/).length > 22)) score -= 5;
  if (listing.description.length < 120) score -= 5;
  if (!/\b(buy now|order now|shop now|add to cart)\b/i.test(listing.description)) score -= 5;
  if (/\b(best|perfect|guaranteed|#1|top-rated)\b/i.test(listing.description)) score -= 5;
  return Math.max(0, score);
}

The score isn't decorative. Every deduction maps to a specific warning, and the UI color-codes the result — green at 80+, amber at 60+, red below. Sellers see exactly which rule their listing would break before hitting publish, and can regenerate with a tighter prompt. There's also a free Listing Checker for validating listings you've already written.

The 30-Second UX

The user flow is deliberately boring-fast:

Paste product name + features
Click generate
Get a scored listing with a compliance badge

No account required for the first 5 generations. That frictionless start is what turned a dev tool into something sellers actually use daily.

What I Learned

Compliance rules change per marketplace — TikTok Shop's rules differ from Amazon's. Keep them in a config, not hardcoded.
Scoring drives trust — a number ("Score: 95") makes sellers feel the AI is accountable. Vague output doesn't.
Compliance-first prompting beats post-hoc validation — when the rules are in the prompt, most outputs pass on the first pass; the deterministic scorer catches the stragglers and tells the seller exactly why.
Free tier is the growth engine — the free tools (listing checker, keyword research) are what bring sellers in; the Pro generator is what keeps them.