Ecommerce SEO Skill
Production-ready automation for high-volume store visibility and conversion.
Overview
Ecommerce SEO differs from content SEO by the scale of pages and the complexity of internal linking. The primary battle is the "Crawl Budget": ensuring Google spends its limited resources on high-value product pages rather than millions of useless facet combinations (e.g., "blue shirt size M color navy"). This skill focuses on faceted navigation control, merchant rich results, and the lifecycle management of product URLs. pip install requests beautifulsoup4 lxml provides the runtime for the audit scripts in this skill.
Money-Making Overview
Buyer Persona:
- Shopify/Magento/WooCommerce store owners ($100K–$5M revenue) with 1,000+ SKUs
- Head of Growth at D2C brands struggling with "indexing bloat"
- Ecommerce agencies specializing in technical SEO for large catalogs
- Marketplace operators managing thousands of vendor-submitted pages
Pricing Tiers:
| Tier |
Price |
Deliverable |
Timeline |
| Indexing Cleanup |
$1,500 |
Facet audit + robots.txt/noindex strategy to kill index bloat and recover crawl budget. |
1 week |
| Merchant-Rich Setup |
$1,000 |
Implementation of Product/Offer schema for all categories + Rich Result validation. |
3 days |
| Store Growth Retainer |
$2,500/mo |
Monthly keyword gap analysis for product categories + landing page optimization for long-tail variants. |
Ongoing |
First-Dollar Timeline:
- Day 1: Run a crawl budget check. Find a store indexing 50k pages but not 1k are "money pages".
- Day 2: Send a screenshot of the "Indexed vs. Valuable" gap. "You're paying Google to crawl filters, not products."
- Week 1: Close a $1,500 Indexing Cleanup engagement.
- Month 1: Upsell to a Retainer to build "Category Power Pages" for high-volume search terms.
When to Use
Trigger phrases:
"ecommerce seo": Best practices for high-volume product catalogs
"Faceted navigation seo": Managing filters to prevent index bloat
"Product schema": implementing Merchant rich results (price, availability, reviews)
"Product variants": Canonicalizing color/size versions without losing long-tail traffic
"Out-of-stock strategy": Managing 404 vs 410 vs 200 for discontinued items
Faceted navigation control: Using robots.txt or noindex to prevent "facet-bombing" the index
Merchant rich results: Implementing Product, Offer, and AggregateRating schema
Variant canonicalization: Deciding when a variant deserves its own URL vs being a canonical child
Product lifecycle management: Handling discontinued products to preserve link equity
Category page optimization: Turning "Product Listing Pages" (PLPs) into authoritative guides
Workflow
- Index Bloat Audit: Analyze GSC to find faceted URLs leaking into the index.
- Facet Logic Mapping: Define which filter combinations are "money" vs "junk".
- Blocking Implementation: Deploy robots.txt
disallow or noindex tags.
- Schema Deployment: implement Product and Offer JSON-LD for all catalog items.
- Variant Canonicalization: Apply canonical tags to a primary SKU for low-volume variants.
- Monitoring: Track "Crawl Budget" usage via log file analysis.
When NOT to Use
- When the store has < 50 products (standard
seo-auditor is enough)
- For pure conversion rate optimization (CRO) without search intent (use conversion skills)
- When the task is about paid shopping ads (use
paid-ads)
- For managing inventory or logistics (use operations)
Anti-Rationalization Table
| Common "Fast" Shortcut |
Why It Fails |
Real Requirement |
| robots.txt for everything |
disallow prevents crawling, so noindex is never seen |
Use noindex for pages that should be removed from index |
| Generic Product Schema |
Missing priceCurrency or availability triggers Merchant Center warnings |
Valid Product/Offer schema with mandatory Merchant properties |
| 404 for Out-of-Stock |
Kills long-tail traffic and creates 404 spikes in GSC |
200 OK with availability: OutOfStock + recommended alternatives |
| Global Canonical |
Canonicalizing all variants to one "Main" product kills long-tail variant queries |
Selective canonicals: keep high-volume variants (e.g. "Red Leather Shoe") indexed |
| Flat Category Tree |
Pushes deep products too far from the root (too many clicks) |
Strategic internal linking + Breadcrumbs for link equity flow |
Key Concepts
Faceted Navigation: noindex vs disallow Trap
Faceted pages (color, size, price sort) explode the crawl graph. The trap: disallowing a URL in robots.txt means Google never crawls it, so a noindex in the HTML head is never seen — the page STAYS indexed. Decision rule:
- Allow crawl +
noindex, follow on thin facet combinations you want link equity to pass through (rare; most facets should be disallowed outright).
disallow in robots.txt for facet combinations that would never rank and waste budget; but this leaves already-indexed facet URLs stuck in index until Google naturally drops them.
rel="canonical" facet URLs back to the base category PLP when the facet is a re-sort (sort=price-low), not a unique inventory slice.
Crawl-budget math: if Googlebot has ~10k fetches/day and a store has 5k real products plus 200k facet URLs, 97% of budget goes to facets. Disallow all facet combinations except the intersection pages you actively build as landing pages (e.g., "men's red shoes").
Product Schema: offers, availability, price/priceCurrency
Merchant rich results require valid Product with an Offer (or AggregateOffer). Mandatory for eligibility:
name, image (array of URLs), one of brand, sku, mpn, or gtin.
offers object with @type: Offer, price (numeric string), priceCurrency (ISO 4217, e.g. USD), availability (http://schema.org/InStock|OutOfStock|PreOrder|BackOrder|Discontinued), and url pointing to the product page.
aggregateRating only if real reviews exist (posting fake ratings = manual action). review entries need author and datePublished.
Wrap the JSON-LD in a <script type="application/ld+json"> in the head. Validate with Google's Rich Results Test before deploy; Merchant Center rejects listings missing price or availability.
Variant Canonicalization Decision Rule
Variants (color/size) should keep separate URLs only when there is demonstrated search demand for that exact variant (e.g., "red leather Chelsea boot" vs "black suede Chelsea boot") — check GSC query data for variant-qualified long-tail keywords. Rule:
- If variant-level monthly searches > 0 AND the variant has unique primary image/meta: self-canonicalize (index separately).
- Otherwise: canonical all variants to the parent product URL; reflect the selected variant via URL parameter (
?color=red) with a canonical to the clean product page.
- Never canonicalize every variant to a single "primary" color when colors are distinct products (Google will drop the non-primary variants from index and you lose long-tail).
Out-of-Stock, Discontinued, and Seasonal Products
- Temporarily out of stock: keep the product page 200 OK with
availability: OutOfStock, show "back in stock soon" + email capture, and rel="alternate" to a substitute. Never 404.
- Discontinued permanently: 410 Gone is ideal (Signals finality, preserved crawl budget) — but only after confirming zero internal links or traffic. If the URL has backlinks, keep a 200 page with
availability: Discontinued and recommend alternatives to preserve link equity.
- Seasonal rotation: keep page 200 with
OutOfStock, refresh content/markup with the season, or canonicalize to the evergreen category if no near-term return.
- 404 vs 410: 404 is "might come back"; 410 is "gone forever". Google recrawls 410s less often, saving budget.
Category Pages (PLPs)
Category pages are the primary ranking assets. Make them authoritative: H1 with primary category keyword, 150–300 words of editorial content above the grid, faceted links as visible filters (but not indexable facet URLs), and BreadcrumbList schema. Avoid infinite scroll without pagination links (rel=next is deprecated but canonical-to-page-1 still useful for thin sorts).
First Action in 60 Minutes
Audit a store's "indexing bloat" by checking if faceted URLs are leaking into the index. A simple probe of site:domain.com/filter often reveals thousands of useless pages.
#!/usr/bin/env python3
import requests
from bs4 import BeautifulSoup
def audit_ecommerce_bloat(url):
# Check for faceted navigation bloat.
# Detects if common filter patterns are indexed and causing bloat.
common_filters = ['filter', 'facet', 'sort', 'color', 'size', 'price', 'category']
bloat_detected = False
try:
resp = requests.get(url, timeout=10)
resp.raise_for_status()
soup = BeautifulSoup(resp.text, 'html.parser')
# Check for internal links that look like facets
links = soup.find_all('a', href=True)
for link in links:
href = link['href']
if any(f in href.lower() for f in common_filters):
print(f"Facet link found: {href}")
bloat_detected = True
if not bloat_detected:
print("No obvious facet links found in the homepage.")
else:
print("Faceted navigation detected. Check GSC to see if these are indexed.")
except Exception as e:
print(f"Error auditing store: {e}")
if __name__ == "__main__":
target = "https://example.com"
audit_ecommerce_bloat(target)
Verification
- Facet-Index Gap: Check Google Search Console "Indexed" vs "Not Indexed" for URLs containing filter parameters. Fewer indexed than total fetched = bloat cleanup working.
- Rich Result Validation: Run product pages through Google Rich Results Test;
offers and price must validate, no Merchant Center warnings.
- Variant Canonical Check: Select a high-volume variant and confirm it self-canonicalizes; low-volume variants canonicalize to parent.
- Product Lifecycle Audit: Discontinued product returns 410 (or 200 with
availability: Discontinued + alternatives); temporarily OOS returns 200 with OutOfStock.
- robots.txt vs noindex Trap Check: Crawl one disallowed-but-noindexed URL; if Googlebot blocks it, noindex will never be seen — confirm the strategy matches the chosen blocking level.
- Breadcrumb Integrity: Every product page has a valid BreadcrumbList schema and a logical path back to the category root.
1---2name: ecommerce-seo3description: Use when optimizing e-commerce stores for search engines. Focus on faceted navigation, product schema, variant canonicalization, and crawl budget management for large catalogs.4domain: marketing5author: oyi776license: Apache-2.07subdomain: marketing8tags:9- growth10- ecommerce11- marketing12- seo13- money14triggers:15- ecommerce seo16- faceted navigation seo17- product schema optimization18- ecommerce crawl budget19- product variant canonicalization20- out of stock seo strategy21argument-hint: "[store_url]"22version: 1.0.023category: marketing24metadata:25 source: https://skillmd.com/skills/oyi77/ecommerce-seo26---2728# Ecommerce SEO Skill2930**Production-ready** automation for high-volume store visibility and conversion.3132## Overview3334Ecommerce SEO differs from content SEO by the scale of pages and the complexity of internal linking. The primary battle is the "Crawl Budget": ensuring Google spends its limited resources on high-value product pages rather than millions of useless facet combinations (e.g., "blue shirt size M color navy"). This skill focuses on faceted navigation control, merchant rich results, and the lifecycle management of product URLs. `pip install requests beautifulsoup4 lxml` provides the runtime for the audit scripts in this skill.3536## Money-Making Overview3738**Buyer Persona:**39- Shopify/Magento/WooCommerce store owners ($100K–$5M revenue) with 1,000+ SKUs40- Head of Growth at D2C brands struggling with "indexing bloat"41- Ecommerce agencies specializing in technical SEO for large catalogs42- Marketplace operators managing thousands of vendor-submitted pages4344**Pricing Tiers:**4546| Tier | Price | Deliverable | Timeline |47|------|-------|---------------|-----------------|48| Indexing Cleanup | $1,500 | Facet audit + robots.txt/noindex strategy to kill index bloat and recover crawl budget. | 1 week |49| Merchant-Rich Setup | $1,000 | Implementation of Product/Offer schema for all categories + Rich Result validation. | 3 days |50| Store Growth Retainer | $2,500/mo | Monthly keyword gap analysis for product categories + landing page optimization for long-tail variants. | Ongoing |5152**First-Dollar Timeline:**53- **Day 1**: Run a crawl budget check. Find a store indexing 50k pages but not 1k are "money pages".54- **Day 2**: Send a screenshot of the "Indexed vs. Valuable" gap. "You're paying Google to crawl filters, not products."55- **Week 1**: Close a $1,500 Indexing Cleanup engagement.56- **Month 1**: Upsell to a Retainer to build "Category Power Pages" for high-volume search terms.5758## When to Use5960**Trigger phrases:**61- "ecommerce seo": Best practices for high-volume product catalogs62- "Faceted navigation seo": Managing filters to prevent index bloat63- "Product schema": implementing Merchant rich results (price, availability, reviews)64- "Product variants": Canonicalizing color/size versions without losing long-tail traffic65- "Out-of-stock strategy": Managing 404 vs 410 vs 200 for discontinued items6667- **Faceted navigation control**: Using robots.txt or noindex to prevent "facet-bombing" the index68- **Merchant rich results**: Implementing Product, Offer, and AggregateRating schema69- **Variant canonicalization**: Deciding when a variant deserves its own URL vs being a canonical child70- **Product lifecycle management**: Handling discontinued products to preserve link equity71- **Category page optimization**: Turning "Product Listing Pages" (PLPs) into authoritative guides7273## Workflow74751. **Index Bloat Audit**: Analyze GSC to find faceted URLs leaking into the index.762. **Facet Logic Mapping**: Define which filter combinations are "money" vs "junk".773. **Blocking Implementation**: Deploy robots.txt `disallow` or `noindex` tags.784. **Schema Deployment**: implement Product and Offer JSON-LD for all catalog items.795. **Variant Canonicalization**: Apply canonical tags to a primary SKU for low-volume variants.806. **Monitoring**: Track "Crawl Budget" usage via log file analysis.8182## When NOT to Use8384- When the store has < 50 products (standard `seo-auditor` is enough)85- For pure conversion rate optimization (CRO) without search intent (use conversion skills)86- When the task is about paid shopping ads (use `paid-ads`)87- For managing inventory or logistics (use operations)8889## Anti-Rationalization Table9091| Common "Fast" Shortcut | Why It Fails | Real Requirement |92|-------------------------|-----------------|------------------------------------------|93| robots.txt for everything | `disallow` prevents crawling, so `noindex` is never seen | Use `noindex` for pages that should be removed from index |94| Generic Product Schema | Missing `priceCurrency` or `availability` triggers Merchant Center warnings | Valid Product/Offer schema with mandatory Merchant properties |95| 404 for Out-of-Stock | Kills long-tail traffic and creates 404 spikes in GSC | 200 OK with `availability: OutOfStock` + recommended alternatives |96| Global Canonical | Canonicalizing all variants to one "Main" product kills long-tail variant queries | Selective canonicals: keep high-volume variants (e.g. "Red Leather Shoe") indexed |97| Flat Category Tree | Pushes deep products too far from the root (too many clicks) | Strategic internal linking + Breadcrumbs for link equity flow |9899## Key Concepts100101### Faceted Navigation: noindex vs disallow Trap102103Faceted pages (color, size, price sort) explode the crawl graph. The trap: disallowing a URL in robots.txt means Google never crawls it, so a `noindex` in the HTML head is never seen — the page STAYS indexed. Decision rule:104105- Allow crawl + `noindex, follow` on thin facet combinations you want link equity to pass through (rare; most facets should be disallowed outright).106- `disallow` in robots.txt for facet combinations that would never rank and waste budget; but this leaves already-indexed facet URLs stuck in index until Google naturally drops them.107- `rel="canonical"` facet URLs back to the base category PLP when the facet is a re-sort (sort=price-low), not a unique inventory slice.108109Crawl-budget math: if Googlebot has ~10k fetches/day and a store has 5k real products plus 200k facet URLs, 97% of budget goes to facets. Disallow all facet combinations except the intersection pages you actively build as landing pages (e.g., "men's red shoes").110111### Product Schema: offers, availability, price/priceCurrency112113Merchant rich results require valid Product with an Offer (or AggregateOffer). Mandatory for eligibility:114115- `name`, `image` (array of URLs), one of `brand`, `sku`, `mpn`, or `gtin`.116- `offers` object with `@type: Offer`, `price` (numeric string), `priceCurrency` (ISO 4217, e.g. USD), `availability` (http://schema.org/InStock|OutOfStock|PreOrder|BackOrder|Discontinued), and `url` pointing to the product page.117- `aggregateRating` only if real reviews exist (posting fake ratings = manual action). `review` entries need author and datePublished.118119Wrap the JSON-LD in a `<script type="application/ld+json">` in the head. Validate with Google's Rich Results Test before deploy; Merchant Center rejects listings missing price or availability.120121### Variant Canonicalization Decision Rule122123Variants (color/size) should keep separate URLs only when there is demonstrated search demand for that exact variant (e.g., "red leather Chelsea boot" vs "black suede Chelsea boot") — check GSC query data for variant-qualified long-tail keywords. Rule:124125- If variant-level monthly searches > 0 AND the variant has unique primary image/meta: self-canonicalize (index separately).126- Otherwise: canonical all variants to the parent product URL; reflect the selected variant via URL parameter (`?color=red`) with a canonical to the clean product page.127- Never canonicalize every variant to a single "primary" color when colors are distinct products (Google will drop the non-primary variants from index and you lose long-tail).128129### Out-of-Stock, Discontinued, and Seasonal Products130131- **Temporarily out of stock**: keep the product page 200 OK with `availability: OutOfStock`, show "back in stock soon" + email capture, and `rel="alternate"` to a substitute. Never 404.132- **Discontinued permanently**: 410 Gone is ideal (Signals finality, preserved crawl budget) — but only after confirming zero internal links or traffic. If the URL has backlinks, keep a 200 page with `availability: Discontinued` and recommend alternatives to preserve link equity.133- **Seasonal rotation**: keep page 200 with `OutOfStock`, refresh content/markup with the season, or canonicalize to the evergreen category if no near-term return.134- **404 vs 410**: 404 is "might come back"; 410 is "gone forever". Google recrawls 410s less often, saving budget.135136### Category Pages (PLPs)137138Category pages are the primary ranking assets. Make them authoritative: H1 with primary category keyword, 150–300 words of editorial content above the grid, faceted links as visible filters (but not indexable facet URLs), and BreadcrumbList schema. Avoid infinite scroll without pagination links (`rel=next` is deprecated but canonical-to-page-1 still useful for thin sorts).139140## First Action in 60 Minutes141142Audit a store's "indexing bloat" by checking if faceted URLs are leaking into the index. A simple probe of `site:domain.com/filter` often reveals thousands of useless pages.143144```python145#!/usr/bin/env python3146import requests147from bs4 import BeautifulSoup148149def audit_ecommerce_bloat(url):150 # Check for faceted navigation bloat.151 # Detects if common filter patterns are indexed and causing bloat.152 common_filters = ['filter', 'facet', 'sort', 'color', 'size', 'price', 'category']153 bloat_detected = False154155 try:156 resp = requests.get(url, timeout=10)157 resp.raise_for_status()158 soup = BeautifulSoup(resp.text, 'html.parser')159160 # Check for internal links that look like facets161 links = soup.find_all('a', href=True)162 for link in links:163 href = link['href']164 if any(f in href.lower() for f in common_filters):165 print(f"Facet link found: {href}")166 bloat_detected = True167168 if not bloat_detected:169 print("No obvious facet links found in the homepage.")170 else:171 print("Faceted navigation detected. Check GSC to see if these are indexed.")172173 except Exception as e:174 print(f"Error auditing store: {e}")175176if __name__ == "__main__":177 target = "https://example.com"178 audit_ecommerce_bloat(target)179```180181## Verification1821831. **Facet-Index Gap**: Check Google Search Console "Indexed" vs "Not Indexed" for URLs containing filter parameters. Fewer indexed than total fetched = bloat cleanup working.1842. **Rich Result Validation**: Run product pages through Google Rich Results Test; `offers` and `price` must validate, no Merchant Center warnings.1853. **Variant Canonical Check**: Select a high-volume variant and confirm it self-canonicalizes; low-volume variants canonicalize to parent.1864. **Product Lifecycle Audit**: Discontinued product returns 410 (or 200 with `availability: Discontinued` + alternatives); temporarily OOS returns 200 with `OutOfStock`.1875. **robots.txt vs noindex Trap Check**: Crawl one disallowed-but-noindexed URL; if Googlebot blocks it, noindex will never be seen — confirm the strategy matches the chosen blocking level.1886. **Breadcrumb Integrity**: Every product page has a valid BreadcrumbList schema and a logical path back to the category root.