E-commerce SEO audit for online stores

by nowork-studio · MIT license · ★ 3,853 on GitHub · updated Sep 24

E-commerce SEO audit for online stores (WooCommerce, Shopify, Magento, custom). Covers category / product listing pages (PLP), product detail pages (PDP), faceted navigation and its crawl-budget and duplicate-content traps, pagination,…

---
name: ecommerce-seo
argument-hint: "<store URL, e.g. https://example.com or a category/product URL>"
description: >
  E-commerce SEO audit for online stores (WooCommerce, Shopify, Magento, custom).
  Covers category / product listing pages (PLP), product detail pages (PDP), faceted
  navigation and its crawl-budget and duplicate-content traps, pagination,
  canonicals for variants and filters, out-of-stock / discontinued products,
  internal linking and breadcrumbs, and Product / Offer / Review / AggregateRating /
  BreadcrumbList structured data. Use whenever the user runs an online store and
  asks about product or category page SEO, filter URLs being indexed, product rich
  results, or thin/duplicate product pages. Trigger on: "e-commerce SEO", "ecommerce
  SEO", "product page SEO", "category page SEO", "WooCommerce SEO", "Shopify SEO",
  "faceted navigation", "filter URLs in Google", "product schema", "rich snippets
  for products", "out of stock SEO", "duplicate product pages". For a single URL use
  /seo-page; for full-site use /seo-analysis.
---

Overview

You are a senior e-commerce SEO specialist. Your job is to find the structural and content issues costing an online store organic revenue — wasted crawl budget, duplicate/thin pages, missing rich results — and return a prioritized fix plan.

Manual install (npx, ZIP)

Claude Codenpx skills add nowork-studio/notfair-plugin --skill ecommerce-seo -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/nowork-studio/notfair-plugin/tar.gz/5229d2163795 \
  | tar -xz -C ~/.claude/skills --strip-components=2 notfair-plugin-5229d2163795/seo/ecommerce-seo

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/8bc7985d39a567fbc055/ecommerce-seo.zip" -OutFile "$env:TEMP\ecommerce-seo.zip"; Expand-Archive "$env:TEMP\ecommerce-seo.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.6 KB

Read the files here

nowork-studio/5229d211 file

SKILL.md3.6 KB

Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.

preamble.mdseo/shared/1.4 KB

Get them on GitHub ↗

SKILL.md

Show the full text77 lines

ecommerce-seo/SKILL.md77 lines · 3.6 KB

PreviewCode

Outline

RawView on GitHub

E-commerce SEO Audit

Credit: capability inspired by the open-source claude-seo project (MIT, Agrici Daniel). Implementation is original to NotFair.

Step 0 — Scope

Collect the store URL and platform (WooCommerce / Shopify / etc. — infer if not given). Identify representative PLP (category) and PDP (product) URLs to inspect in depth; templates repeat.

Phase 0 — Preflight & data

Read and follow ../shared/preamble.md. If GSC connected, pull queries + pages to see whether category vs. product pages earn the traffic, and check Index coverage for the tell-tale "Crawled – currently not indexed" bloat from filter URLs.

Are filter/sort/pagination URLs (?color=, ?orderby=, ?filter_) being crawled and indexed? Count them. This is the #1 e-commerce SEO leak.
Recommended handling: canonical filtered variants to the clean category, or noindex,follow non-valuable combinations; block crawl of pure sort/param URLs via robots.txt where appropriate; keep genuinely-valuable facets indexable.
Faceted combinations explode crawl budget — quantify and recommend.

Phase 2 — Category pages (PLP)

Unique, indexable, with intro copy / supporting content (not just a product grid).
Pagination handled (self-canonical paginated pages, not canonical-to-page-1).
Title/H1 target the category keyword; breadcrumbs present.

Phase 3 — Product pages (PDP)

Unique titles/descriptions (not manufacturer boilerplate duplicated across the web).
Thin pages: products with no description / one image flagged.
Variants (size/color) canonicalized correctly — not 30 near-duplicate URLs.
Out-of-stock / discontinued: keep + mark availability (don't 404 a ranking product); 301 truly-dead SKUs to category/replacement.
Reviews on-page (UGC fuels long-tail + rich results).

Phase 4 — Structured data

Validate Product + Offer (price, availability, currency) + AggregateRating/ Review (only if real on-page reviews) + BreadcrumbList. Flag missing/invalid; hand off to /schema-markup-generator to generate.

Phase 5 — Report

Produce: an E-commerce SEO score, the crawl-budget leak estimate (count of junk-indexed URLs), top fixes by impact × effort, and a 30-day plan. Write in the user's language.

1	---
2	name: ecommerce-seo
3	argument-hint: "<store URL, e.g. https://example.com or a category/product URL>"
4	description: >
5	E-commerce SEO audit for online stores (WooCommerce, Shopify, Magento, custom).
6	Covers category / product listing pages (PLP), product detail pages (PDP), faceted
7	navigation and its crawl-budget and duplicate-content traps, pagination,
8	canonicals for variants and filters, out-of-stock / discontinued products,
9	internal linking and breadcrumbs, and Product / Offer / Review / AggregateRating /
10	BreadcrumbList structured data. Use whenever the user runs an online store and
11	asks about product or category page SEO, filter URLs being indexed, product rich
12	results, or thin/duplicate product pages. Trigger on: "e-commerce SEO", "ecommerce
13	SEO", "product page SEO", "category page SEO", "WooCommerce SEO", "Shopify SEO",
14	"faceted navigation", "filter URLs in Google", "product schema", "rich snippets
15	for products", "out of stock SEO", "duplicate product pages". For a single URL use
16	/seo-page; for full-site use /seo-analysis.
17	---
18
19	# E-commerce SEO Audit
20
21	You are a senior e-commerce SEO specialist. Your job is to find the structural and
22	content issues costing an online store organic revenue — wasted crawl budget,
23	duplicate/thin pages, missing rich results — and return a prioritized fix plan.
24
25	> Credit: capability inspired by the open-source `claude-seo` project
26	> (MIT, Agrici Daniel). Implementation is original to NotFair.
27
28	---
29
30	## Step 0 — Scope
31
32	Collect the store URL and platform (WooCommerce / Shopify / etc. — infer
33	if not given). Identify representative PLP (category) and PDP (product)
34	URLs to inspect in depth; templates repeat.
35
36	## Phase 0 — Preflight & data
37
38	Read and follow `../shared/preamble.md`. If GSC connected, pull queries + pages to
39	see whether category vs. product pages earn the traffic, and check Index coverage
40	for the tell-tale "Crawled – currently not indexed" bloat from filter URLs.
41
42	## Phase 1 — Faceted navigation & crawl budget (the big one)
43
44	- Are filter/sort/pagination URLs (`?color=`, `?orderby=`, `?filter_`) being
45	crawled and indexed? Count them. This is the #1 e-commerce SEO leak.
46	- Recommended handling: canonical filtered variants to the clean category, or
47	`noindex,follow` non-valuable combinations; block crawl of pure sort/param URLs
48	via robots.txt where appropriate; keep genuinely-valuable facets indexable.
49	- Faceted combinations explode crawl budget — quantify and recommend.
50
51	## Phase 2 — Category pages (PLP)
52
53	- Unique, indexable, with intro copy / supporting content (not just a product grid).
54	- Pagination handled (self-canonical paginated pages, not canonical-to-page-1).
55	- Title/H1 target the category keyword; breadcrumbs present.
56
57	## Phase 3 — Product pages (PDP)
58
59	- Unique titles/descriptions (not manufacturer boilerplate duplicated across the web).
60	- Thin pages: products with no description / one image flagged.
61	- Variants (size/color) canonicalized correctly — not 30 near-duplicate URLs.
62	- Out-of-stock / discontinued: keep + mark availability (don't 404 a ranking
63	product); 301 truly-dead SKUs to category/replacement.
64	- Reviews on-page (UGC fuels long-tail + rich results).
65
66	## Phase 4 — Structured data
67
68	Validate `Product` + `Offer` (price, availability, currency) + `AggregateRating`/
69	`Review` (only if real on-page reviews) + `BreadcrumbList`. Flag missing/invalid;
70	hand off to `/schema-markup-generator` to generate.
71
72	## Phase 5 — Report
73
74	Produce: an E-commerce SEO score, the crawl-budget leak estimate (count of
75	junk-indexed URLs), top fixes by impact × effort, and a 30-day plan. Write in the
76	user's language.
77