Use this skill when optimizing e-commerce sites for search engines - product page SEO, faceted navigation crawl control, category taxonomy, product schema markup, pagination handling, inventory-aware SEO (out-of-stock pages), and e-commerce site architecture. Triggers on any task involving online store search optimization, product listing pages, shopping search results, or e-commerce technical SEO challenges.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Instruções da origem · Visualização somente leitura
name
ecommerce-seo
version
0.1.0
description
Use this skill when optimizing e-commerce sites for search engines - product page SEO, faceted navigation crawl control, category taxonomy, product schema markup, pagination handling, inventory-aware SEO (out-of-stock pages), and e-commerce site architecture. Triggers on any task involving online store search optimization, product listing pages, shopping search results, or e-commerce technical SEO challenges.
When this skill is activated, always start your first response with the 🧢 emoji.
E-commerce SEO
E-commerce SEO is a specialized discipline distinct from standard website SEO. The scale,
dynamism, and structure of online stores create unique challenges: millions of URLs generated
by product variants and faceted navigation, rampant duplicate content from sorting and
filtering, constant inventory churn as products go out of stock or discontinued, and intense
competition for shopping-specific features like rich snippets and Google Shopping placements.
This skill provides the patterns and decision frameworks needed to win search for online stores.
When to use this skill
Trigger this skill when the user:
Wants to improve search rankings for product pages or product listing pages (PLPs)
Asks about faceted navigation, product filters, or URL parameter handling
Needs to implement or improve product schema (structured data, rich snippets)
Is designing category taxonomy, breadcrumbs, or site architecture for a store
Wants to handle pagination on category or search results pages
Needs to manage SEO for out-of-stock, discontinued, or seasonal products
Asks about duplicate content caused by product variants (color, size, etc.)
Is working on shopping feed optimization or Google Merchant Center integration
Wants to understand crawl budget management for large catalogs
Do NOT trigger this skill for:
General website SEO without an e-commerce context (use the technical-seo-engineering skill)
Paid shopping ads (Google Shopping campaigns, PMax) - that is a paid media topic
Key principles
Faceted navigation is the #1 crawl budget killer in e-commerce - A store with
10,000 products can generate millions of filter URL combinations. Without explicit
crawl control, Googlebot spends its entire budget on low-value filtered pages instead
of product and category pages. Always have a faceted navigation crawl strategy before
launch.
Category pages often outrank product pages for commercial queries - Searchers
looking for "men's running shoes" want options, not a single product. Invest as much
SEO effort in category pages (unique introductory copy, internal linking, facet
strategy) as in product pages.
Product schema is table stakes for shopping results - Without valid Product +
Offer structured data, products are ineligible for rich snippets, Google Shopping
free listings, and review stars. Implement it on every product page, not just
featured items.
Out-of-stock is not the same as discontinued - treat them differently - A
temporarily unavailable product still has SEO equity, backlinks, and likely returning
stock. A discontinued product needs a 301 redirect strategy. Conflating the two leads
to unnecessary traffic loss or thin-content penalties.
Internal linking through breadcrumbs and related products builds authority -
E-commerce sites are link-poor by nature (few editorial backlinks per product). A
strong internal linking architecture - breadcrumbs, related products, "customers also
bought" sections, and category crosslinks - distributes PageRank from the domain to
deep product pages.
Core concepts
Page type roles
E-commerce sites have three distinct page types with different SEO roles:
Category pages (PLPs): Target broad commercial queries ("women's boots", "4K TVs").
High traffic potential. Should have unique introductory copy, subcategory links, and
facet links to high-value subsets. These are your most important SEO assets.
Product pages (PDPs): Target specific queries ("Nike Air Max 270 size 10 black").
Lower individual volume but high purchase intent. Differentiate with reviews, specs,
and detailed descriptions.
Listing/search results pages: Dynamically generated, often lower value. Apply
noindex or canonical control by default unless the query has clear organic demand.
Faceted navigation
Faceted navigation lets users filter products by attributes (brand, color, size, price
range). Each filter combination typically generates a unique URL. A category with 5 brands
x 8 colors x 6 sizes = 240 URLs from one page. Without controls, Googlebot crawls all of
them - and most are near-duplicate, thin pages that dilute crawl budget and may trigger
quality signals.
The spectrum of crawl control:
robots.txt Disallow - prevents crawling entirely, no PageRank flows through
noindex, follow meta tag - crawled but not indexed, PageRank flows
Canonical tag pointing to the base category - indexed under category URL
AJAX/JavaScript-only filtering - no new URLs generated
Selective indexing of high-value combinations - allows "blue women's boots" to rank
The right approach depends on whether filter combinations have real organic search demand.
Pagination
rel="next" / rel="prev" were officially deprecated by Google in 2019. Modern
approaches:
Numbered pages: Allow indexing of all paginated pages. Canonical each page to
itself (not to page 1). Ensure page 2+ have unique title tags.
View-all: A single page showing all items, canonicalled from paginated series. Only
viable if the page loads fast enough for Googlebot to render.
Infinite scroll / load more: Must be backed by discrete URLs for SEO. Pure
JavaScript infinite scroll creates a single indexed page.
Product lifecycle SEO
Products move through states that require different SEO handling:
In-stock: Full optimization, product schema with InStock availability
Out-of-stock (temporary): Keep the page, update schema to OutOfStock, add
back-in-stock messaging - do not redirect or delete
Discontinued (permanent): 301 redirect to the category, the closest replacement
product, or a curated "alternatives" landing page
Seasonal: Keep URLs year-round if the product recurs, use PreOrder or
Discontinued availability status in the off-season
Shopping search features
Google surfaces e-commerce content in multiple ways beyond blue links:
Shopping tab / free listings: Requires Google Merchant Center feed + Product schema
Alt text: Nike Air Max 270 in black, men's size 10, side view
Serve multiple angles - Google Images is a significant traffic source for e-commerce
Use ImageObject schema for primary product image
Variant handling: When a product has variants (colors, sizes), consolidate all
variants under one canonical URL unless each variant has distinct search demand. Avoid
separate indexable URLs for product?color=red and product?color=blue unless "red
[product name]" is a real query with search volume.
Review integration: Display review count and average rating visibly on the page.
Implement AggregateRating schema. Reviews are a significant ranking signal and improve
click-through rate in search results.
See references/product-page-optimization.md for a full checklist.
Control faceted navigation crawling
Step 1: Audit current crawl waste
Use a log file analysis tool or Google Search Console > Coverage to identify how many
filter URLs Googlebot is crawling. Compare against your total page inventory.
Step 2: Choose a strategy per filter type
Filter type
Search demand?
Recommended approach
Brand + category (e.g. "Nike running shoes")
Yes, often high
Allow indexing
Color + category (e.g. "black boots")
Sometimes
Selective indexing
Size filters
Rarely
noindex, follow or canonical
Sort order (?sort=price_asc)
Never
robots.txt Disallow or canonical
Page number beyond page 3
Rarely
Canonical to page 1 if thin
Multiple combined filters
Rarely
Canonical to base category
Step 3: Implement
For noindex, follow on filtered pages:
<!-- In <head> of filtered pages only --><metaname="robots"content="noindex, follow">
For canonical control (filtered page points to base category):
See references/category-pagination.md for the full breakdown. Key decisions:
Choose your pagination model:
Numbered pages (/womens/boots?page=2): Best default for SEO. Allows indexing of all
pages, distributes crawl across catalog.
View-all (/womens/boots?view=all): Only use if page is fast to render (< 3s in
Googlebot's simulated browser). Canonical all paginated URLs to this page.
Load more / infinite scroll: Requires URL fragments or history.pushState to be SEO
crawlable. JavaScript-only implementation = page 1 gets all the credit.
Canonical rules for pagination:
Page 1: canonical to itself (/womens/boots/)
Page 2+: canonical to themselves (/womens/boots?page=2) - not to page 1
Paginated pages should NOT be canonicalled to page 1 unless you want only page 1
indexed
Manage out-of-stock and discontinued products
Decision tree:
Product unavailable - which case?
|
+-- Temporarily out of stock (will return)
| -> Keep page, set availability = OutOfStock in schema
| -> Add "notify me" widget (engagement signal, conversion value)
| -> Do NOT redirect or noindex
|
+-- Discontinued but has a direct replacement
| -> 301 redirect to the replacement product
| -> Keep redirect in place permanently
|
+-- Discontinued with no replacement
| -> Does the page have backlinks or significant traffic?
| YES: 301 redirect to the parent category
| NO: 410 Gone (tells Google the page is intentionally removed)
|
+-- Seasonal (returns next year)
-> Keep URL live year-round
-> Update schema availability to PreOrder before season
-> Update copy to reflect off-season status
Build internal linking for e-commerce
E-commerce sites have fewer editorial backlinks per product than content sites. Internal
linking compensates by distributing PageRank from high-authority pages (homepage, top
categories) down to product pages.
Internal linking patterns:
Breadcrumbs: Every product and category page. Schema-marked. Essential.
Related products: 4-8 products. Link by category similarity or co-purchase data.
Use descriptive anchor text (product name, not "you might also like").
"Shop the look" or bundles: Cross-category internal links that create non-hierarchical
paths through the catalog.
Category crosslinks in copy: Introductory category copy should mention and link to
complementary categories.
Sitelinks: Homepage + top navigation links concentrate authority. Ensure your top 5-8
categories are in the main navigation.
Use noindex or canonical for low-demand filter combinations
Thin or templated product descriptions
Triggers thin content signals, can't rank for long-tail queries
Write unique copy per product, include specs, use cases, reviews
Missing or invalid product schema
Ineligible for rich snippets, free listings, review stars
Validate with Google's Rich Results Test before launch
404ing out-of-stock products
Destroys SEO equity and backlink value for popular products
Keep page, update schema availability to OutOfStock
Duplicate title tags across variants
Signals low quality, cannibalizes the same query
Unique titles per product; use canonical for truly duplicate variants
Canonicalling paginated pages to page 1
Removes deep catalog pages from index, pages 2+ lose credit
Canonical each page to itself
Blocking CSS/JS from Googlebot
Googlebot can't render the page correctly, may see blank content
Verify rendering in Google Search Console > URL Inspection
Identical meta descriptions across hundreds of products
Missed opportunity; seen as low quality
Use a template with dynamic product data (name, price, attributes)
Lazy-loading product images without noscript fallback
Googlebot may not execute the lazy loader, misses images
Use native loading="lazy" (Googlebot supports it) or include noscript
No breadcrumbs
Weak internal linking, no BreadcrumbList schema for rich display
Implement breadcrumbs on all product and category pages
Gotchas
Canonicalling paginated category pages to page 1 removes them from the index - This is one of the most common e-commerce SEO mistakes. Each paginated page should canonical to itself, not to page 1. Canonical to page 1 tells Google "this is a duplicate of page 1" and Google drops pages 2+ from the index, hiding products from search.
Product schema price must exactly match the on-page price - Google cross-validates the structured data price against the rendered page. A mismatch (e.g., schema shows $99 but the page renders $99.99 with taxes) causes rich snippet ineligibility. Ensure both values are sourced from the same data point.
JavaScript-only facet filters create zero indexable URLs - If filtering updates the DOM without changing the URL (no history.pushState, no query params), Googlebot sees only the base category page. All filter combinations are invisible to search. You need distinct URLs for any filter combination you want indexed.
noindex on filtered pages doesn't prevent crawl waste - noindex, follow tells Google not to index the page but still crawls it. For high-volume filter combinations with zero search demand (sort orders, page numbers beyond page 3), robots.txt Disallow stops the crawl entirely, preserving crawl budget.
Out-of-stock products 404'd lose their backlinks permanently - Returning a 404 for a temporarily unavailable product destroys accumulated link equity and may take months to recover if the product returns to stock. Keep the page live, update the availability schema to OutOfStock, and add a back-in-stock notification.
References
For deep-dive implementation guides, load the relevant file from references/:
references/product-page-optimization.md - Full product page SEO checklist: title
formulas, image optimization, review integration, variant handling, cross-sell linking.
Load when working on individual product page optimization.
references/faceted-navigation.md - The faceted navigation crawl problem explained,
robots.txt strategies, canonical vs noindex trade-offs, AJAX filtering, URL parameter
handling in Google Search Console. Load when dealing with filter/facet URL management.
references/category-pagination.md - Pagination strategy comparison (numbered vs
infinite scroll vs view-all), SEO implications of each, canonical handling for paginated
series, category page optimization patterns. Load when structuring category pages or
choosing a pagination model.
Only load a references file if the current task requires it - they are detailed and will
consume context.
Companion check
On first activation of this skill in a conversation: check which companion skills are installed by running ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null. Compare the results against the recommended_skills field in this file's frontmatter. For any that are missing, mention them once and offer to install:
