/seo-ecommerce

name: seo-ecommerce
description: Optimizes e-commerce SEO across product and category pages — on-page product elements, Product schema validation, image SEO, and faceted/canonical strategy for filters and variants. Uses DataForSEO Merchant for Google Shopping and Amazon marketplace intelligence when connected; otherwise audits feed basics and on-page signals manually. Trigger when the user says "ecommerce SEO", "product SEO", "product schema", "Google Shopping", "Amazon SEO", "marketplace SEO", "product listings", "shopping ads", or "merchant SEO".

seo-ecommerce

**Family:** seo **Status:** Stable

Purpose

E-commerce-specific SEO. The free path fully covers on-page product SEO and Product schema; marketplace intelligence (Google Shopping, Amazon) is the optional DataForSEO-Merchant path.

Triggers

• "ecommerce seo" / "product seo" / "merchant seo"
• "product schema" / "product listings"
• "google shopping" / "shopping ads" / "amazon seo" / "marketplace seo"

Inputs

• Domain or product URL(s)
• Marketplace coverage (Google Shopping / Amazon / both / none)
• Competitor domains (optional)

Steps

1. **Audit product pages** (free path): unique, benefit-led titles + descriptions; one h1; descriptive URL; internal links to category/related; review content present. Run `seo-page` per key product. 2. **Validate Product schema** via `seo-schema`: require `name` + `image`; for merchant eligibility include `offers` with `price` + `priceCurrency` + `availability`, plus `aggregateRating`/`review` **only when real**. 3. **Image SEO** via `seo-image-audit` (product photos are conversion- and ranking-critical: alt, format, size, CLS). 4. **Category/faceted strategy** — canonical handling for filters/sort, thin-variant consolidation (coordinate with `seo-programmatic`). 5. **Marketplace (optional).** If DataForSEO is configured, pull Google Shopping presence and Amazon/keyword-gap data; otherwise state what it would add and check feed basics manually. 6. **Render** per-product scores, schema validation, and a prioritized fix list.

Outputs

• Per-product on-page scores + prioritized fixes
• Product schema validation report
• Marketplace presence/gap report (when DataForSEO present) or a manual checklist

Dependencies

• `seo-schema` (Product schema), `seo-page` (per-product), `seo-image-audit` (images)
• Optional: DataForSEO Merchant (Google Shopping/Amazon), `seo-programmatic` (facets)

Notes

Conditional in `seo-audit` — fires on e-commerce signals (cart, checkout, Product schema). Never fabricate ratings/reviews in schema — it's a manual action risk.