Listing Optimizer¶

Capability slug: marketplace_listing_optimizer Plan Tier: Accelerate (Quick Score) · Command/Premium (Full Analysis + Competitive Benchmark) Feature flag: settings_features.listing_optimizer_v2_enabled

Overview¶

The Listing Optimizer turns a single AWS Marketplace listing into one 0–100 score plus a clear, per-field path to raise it. The score combines three components — the same three that determine whether buyers and their AI assistants find, trust, and surface your listing — and weights them according to your listing's category, because each category is discovered differently.

It scores listings that Listing Sync imports, and feeds the SEO signal behind the Discovery Dashboard's Hero score.

The three components¶

Component	What it measures	Source
Listing Quality	Rule-based copy quality — the grounding text agents read and cite (title, descriptions, highlights, categories)	`FieldSeoScoringService`
Backlink Authority	External trust / domain authority — is this an established, safe vendor	`BacklinkAuthorityService` (DataForSEO, Bedrock fallback)
AI Visibility	Prompt coverage + structured data + brand voice — how AI assistants surface and describe you	`PromptCoverageService`, `FaqStructuredDataService`, `BrandVoiceMatchService`

The overall score is the weighted combination of these three, computed by UnifiedListingScoreService over whichever components are present.

Category-aware weight profiles¶

Each AWS Marketplace category has different discovery physics, so the three components are weighted per category (ListingScoreWeights::PROFILES). The weights are also a signal in themselves — a high AI-visibility weight in the agent category tells vendors how to win there. Each profile sums to 100.

Category	Listing Quality	Backlink Authority	AI Visibility
SaaS (baseline)	40	25	35
AI Agents & Tools	35	15	50
AMI	45	25	30
Container	45	25	30
Professional Services	45	30	25

Why they differ:

SaaS — mature, mixed human + agent discovery; the baseline.
AI Agents & Tools — agent-native, often consumed agent-to-agent; young domains mean thin backlinks, so AI visibility carries the most weight.
AMI / Container — infrastructure you run in your VPC; spec-driven copy plus security/vendor trust lead.
Professional Services — buying expertise; firm reputation dominates and humans procure, so AI lags.

Category resolution

The profile is resolved per listing from its catalog_type and category_tags. AI Agents & Tools is a sub-facet of SaaS (catalog_type reads SAAS for both), so the agent tag in category_tags is what distinguishes it. Data products and any unknown/unmapped category inherit the SaaS baseline.

Scoring modes¶

The optimizer runs in one of three modes (the mode pill):

Mode	Name	What it does	Tier
`quick` (default)	Quick Score	Rides the 7-day signal cache for a fast re-score	Included
`full`	Full Analysis	Force-refreshes every live signal past its cache (DataForSEO backlinks, Brave prompt coverage, Bedrock brand voice, FAQ schema) and re-scores	Premium
`bench`	Competitive Benchmark	Side-by-side scoring against named competitors	Premium

Quick Score is the everyday default — fast, because it reuses cached signals. Full Analysis is the deep pass that re-pulls everything fresh. Competitive Benchmark scores you against named rivals.

The Premium gate¶

Quick Score is available to anyone with the optimizer. Full Analysis and Competitive Benchmark sit behind a Premium tier:

Both carry a Premium badge in the mode UI.
Selecting either surfaces an upgrade CTA.
They do genuine extra work — a full live re-pull (Full Analysis) or competitor scoring (Benchmark) — which is why they're tier-gated.

Real work, hence Premium

Full Analysis re-pulls and re-caches every live signal rather than reusing the cache; Competitive Benchmark scores against named competitors. Credit billing for these is wired separately as billable entities are registered.

Score interpretation¶

Score	Meaning
80–100	Strong — minor improvements possible
60–79	Good — several optimization opportunities
Below 60	Significant room for improvement

The optimizer returns the overall score, the category profile in use, a per-component breakdown (each component shows its weight and its score, with zero-weight components collapsed), and per-field rows grouped into Listing core, Backlink authority, and AI visibility — each with state and improvement guidance.

What this is not¶

A listing builder. The optimizer scores and improves an existing listing. Listing creation happens in AWS or a Build tool; imported listings arrive via Listing Sync.
The standalone AI-visibility tracker. That's a separate capability — marketplace_listing_seo — covering ChatGPT/Claude/Perplexity mentions + backlinks. See Agent Discoverability Score.
A pre-publish proof check. For whether your website/reviews/AWS content back the listing before you publish, use the Listing Alignment Grader.

Plan availability¶

Capability	Starter	Accelerate	Command
Quick Score	—	✅	✅
Full Analysis (Premium)	—	—	✅
Competitive Benchmark (Premium)	—	—	✅