seo-ecommerce

Trigger phrases

Phrases that activate this skill when typed to Claude Code:

• ecommerce SEO
• product SEO
• Google Shopping
• product schema
• marketplace SEO

What it does

seo-ecommerce is a Claude Code skill from AgriciDaniel’s claude-seo repo. It covers both on-page product SEO (no external APIs needed) and live marketplace intelligence via the DataForSEO Merchant API (optional). Original contribution by Matej Marjanovic (Pro Hub Challenge).

The on-page analysis checks a product page SEO checklist across six scoring categories: schema completeness (25%), image optimization (20%), content quality (20%), title and meta (15%), internal linking (10%), and technical (10%). The schema validation enforces Google Merchant Center requirements — correct property types, no currency symbols in the price field, ISO 8601 dates in priceValidUntil, valid availability enums — and scores completeness from required fields (50/100) up to full rich results eligibility with reviews and return policy (100/100). When DataForSEO is available, it adds live Google Shopping competitive pricing, seller landscape data, Amazon cross-marketplace comparison, and a gap analysis between organic keyword rankings and Shopping visibility.

When to use it

Reach for it when:

• You want to know why a product page isn’t generating rich results in Google — the schema validation will find the exact field causing the failure
• You need a competitive pricing snapshot for a product category before setting your own prices
• You suspect keywords you rank for organically are missing from your Shopping feed

When not to reach for it:

• The URL is a category page or homepage rather than a product page — the skill detects this and suggests /seo ecommerce schema instead
• You need Amazon data without DataForSEO installed — Amazon endpoints require the Merchant API extension

Install

Copy the seo-ecommerce SKILL.md into .claude/skills/seo-ecommerce/.

Trigger phrases: “ecommerce SEO”, “product SEO”, “Google Shopping”, “marketplace SEO”, “product schema”, “Amazon SEO”, “product listings”, “shopping ads”, “merchant SEO”.

Commands: /seo ecommerce <url> (full analysis), /seo ecommerce products <keyword> (Shopping competitive analysis, requires DataForSEO), /seo ecommerce gaps <domain> (organic vs Shopping keyword gap), /seo ecommerce schema <url> (schema-only validation).

What a session looks like

A typical session has three phases:

1. Product page on-page audit. The skill fetches and parses the product page, runs the SEO checklist (title format, meta description, heading structure, image alt text, breadcrumb navigation, unique product description, specs table, UGC reviews), and produces a weighted score across the six categories.
2. Schema validation and enhancement. Existing Product JSON-LD is extracted and validated against Google Merchant Center requirements. Missing recommended properties (sku, gtin, aggregateRating, shippingDetails, hasMerchantReturnPolicy) are identified with a schema score showing exactly how many rich result features each addition would unlock.
3. Marketplace intelligence (optional). With DataForSEO, a live Shopping competitive snapshot shows price distribution (min, max, median), seller landscape (top 10 merchants by listing count), and the organic-vs-Shopping gap table sorted by keyword volume.

Receipts

Works well: The schema scoring ladder (50/100 for required fields → 100/100 for full rich results) makes it clear exactly which schema properties to add next and what each addition buys in terms of SERP features. This is more actionable than a generic “schema is valid/invalid” result.

Backfires: The organic-vs-Shopping gap analysis requires DataForSEO for both organic rankings and Shopping data. Without it, the gap analysis section is skipped entirely — which means you cannot get this insight from the free tier alone.

Pattern that works: Run /seo ecommerce schema <url> on every product template you use, not just individual products. A schema bug in a template affects every product page at once; finding and fixing it at the template level is the highest-leverage schema work on an e-commerce site.

Source and attribution

Originally written by AgriciDaniel, incorporating contribution from Matej Marjanovic (Pro Hub Challenge). The canonical SKILL.md and supporting files live in the seo-ecommerce folder of the claude-seo repository.

License: MIT. Install, adapt, and redistribute with attribution preserved.

This page documents the skill from a practitioner’s perspective. For the formal spec and updates, defer to the source repo.