HOME SKILLS BLOG GITHUB
// SKILL

E-COMMERCE SEO
SHOPPING + MARKETPLACE

E-commerce SEO is its own discipline. Product pages have their own schema requirements. Rankings live on Google Shopping and Amazon, not just web search. Pricing changes affect rankings overnight. Marketplace keywords differ from web keywords. Claude SEO E-commerce combines on-page product optimization with live marketplace data from DataForSEO Merchant API.

CONTRIBUTED BY MATEJ MARJANOVIC · PRO HUB CHALLENGE · original repo
$
/seo ecommerce https://your-store.com

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

Claude SEO e-commerce SEO with Google Shopping, Amazon marketplace, and product schema
// HOW IT WORKS

PRODUCT SEO + MARKETPLACE INTEL

E-commerce SEO is not a subset of web SEO. Product pages compete on three different surfaces at once: Google web search, Google Shopping (free organic listings and paid Shopping Ads), and Amazon marketplace search. Each surface has its own ranking factors, its own keyword behavior, and its own schema expectations.

The skill runs a unified analysis. On-page audits cover Product schema completeness, title and meta structure, image quality, content uniqueness, and internal linking. Marketplace audits pull live data from the DataForSEO Merchant API: Google Shopping SERPs, Amazon search results, seller and pricing distributions, and keyword visibility gaps between organic and Shopping channels.

/seo ecommerce <url> GOOGLE WEB product schema on-page audit GOOGLE SHOPPING free listings + ads merchant API AMAZON search + BSR ASIN or keyword UNIFIED E-COMMERCE REPORT Schema score, pricing analysis, marketplace gaps, action plan

The Six Coverage Areas

One skill, six analytical lenses. Run them all with the full command or scope to a single area with subcommands.

01
PRODUCT SCHEMA
Validates Product, Offer, AggregateRating, Review schema against Google Merchant Center requirements. Auto-generates JSON-LD for missing fields.
02
GOOGLE SHOPPING
Live Shopping SERP analysis via DataForSEO Merchant API. Identifies competing sellers, their pricing, organic vs paid placement.
03
AMAZON MARKETPLACE
Amazon search rank, sponsored placements, Best Sellers Rank, ratings distribution, top reviews keyword frequency. ASIN or keyword input.
04
COMPETITOR PRICING
Track competitor pricing across Google Shopping and Amazon. Flags pricing changes that may affect your visibility.
05
MARKETPLACE KEYWORDS
Marketplace keyword gap analysis. Marketplace shoppers search differently than web users. Find the gaps.
06
CATEGORY ARCHITECTURE
Validates your product category and faceted-navigation architecture against SERPs. Flags thin categories and over-pagination.
// USAGE

HOW TO RUN IT

Commands

CommandWhat it does
/seo ecommerce <url>Full e-commerce SEO analysis of a product page or store
/seo ecommerce shopping <query>Google Shopping SERP analysis: sellers, pricing, organic vs paid
/seo ecommerce amazon <asin|keyword>Amazon marketplace data: rank, BSR, ratings, review keywords
/seo ecommerce schema <url>Product schema validation only (no marketplace data required)
/seo ecommerce pricing <competitor-url>Competitor pricing snapshot across Shopping and Amazon

DataForSEO Merchant API

The Shopping, Amazon, pricing, and marketplace-gaps surfaces all rely on the DataForSEO Merchant API. This is a paid endpoint unlocked through the DataForSEO extension, with cost guardrails built in. Every Merchant API call is gated by scripts/dataforseo_costs.py check which returns approved, needs_approval, or blocked based on your daily budget. Amazon endpoints sit in the warn_endpoints set and always require explicit approval. The cost configuration was also contributed by Matej as part of the same Pro Hub Challenge submission.

Schema validation, on-page product audits, image checks, and content quality scoring run without DataForSEO. You can use those surfaces on a free, MIT-licensed install with no API keys.

Cross-Skill Integration

E-commerce SEO is not isolated. It cross-references the specialist skills:

  • Product schema → /seo schema for full structured-data coverage beyond Product
  • Live marketplace data → /seo dataforseo for SERP, keywords, backlinks beyond Merchant API
  • Product images → /seo images for alt-text, format, and Google Shopping dimension checks
  • Description quality → /seo content for E-E-A-T scoring on product copy
  • Full site audit → /seo audit orchestrator auto-detects e-commerce sites and spawns this skill

Output

A unified e-commerce SEO report with an overall score, sub-scores per area, marketplace intelligence (when DataForSEO is available), and a prioritized list of recommendations tagged Critical, High, Medium.

// FAQ

QUESTIONS ABOUT E-COMMERCE SEO

Product pages have schema requirements (Product, Offer, AggregateRating, Review) that other pages do not. They compete on Google Shopping and Amazon, not just web search, and each has different ranking factors. Pricing and availability changes affect rankings within hours. Marketplace keywords differ from web keywords (people search 'wireless headphones under $100' on Amazon, not 'best wireless headphones' on Google). E-commerce SEO bundles all of that into one skill.
Product schema must include name, image, description, sku or gtin, brand, offers (with price, priceCurrency, availability), and ideally aggregateRating and review. The skill validates against Google's current Merchant Center requirements, which are stricter than Schema.org's spec. Missing required fields disqualify your products from rich results and Google Shopping organic placements.
Run /seo ecommerce shopping <query> to see which products rank organically in Google Shopping for that query. The skill uses DataForSEO Merchant API to pull the live SERP. It identifies competing sellers, their pricing, and whether they have Free Listings (organic, free) or paid Shopping Ads placements. Use to find where your products are missing organic exposure.
Yes. Run /seo ecommerce amazon <asin-or-keyword>. The skill pulls Amazon marketplace data: search rank, sponsored placements, Best Sellers Rank, ratings distribution, top reviews keyword frequency. Useful for marketplace keyword gap analysis and listing optimization.
Matej Marjanovic via the AI Marketing Hub Pro Hub Challenge. He also contributed the DataForSEO cost guardrails and the seo-aso (App Store Optimization) extension proposal. Original at github.com/matej-marjanovic/claude-seo. Integrated into Claude SEO v1.9.0 with Matej's permission.
// RELATED SKILLS

EXPLORE MORE

SCHEMA MARKUP

Product schema is one slice of structured data. The full schema skill covers 30+ types.

SCHEMA MARKUP GENERATOR →

DATAFORSEO LIVE DATA

E-commerce uses the DataForSEO Merchant API. The DataForSEO extension also unlocks live SERP, keywords, backlinks.

DATAFORSEO LIVE DATA →

FULL SITE AUDIT

Run a full audit on your store. The orchestrator auto-detects e-commerce sites and spawns this skill.

FULL SITE AUDIT →

VIEW ALL 23 SKILLS →

// FROM THE BLOG

RELATED GUIDES

SCHEMA MARKUP GENERATOR GUIDE

Product schema is the highest-impact schema type for e-commerce. Read how Claude SEO detects, validates, and generates Product, Offer, AggregateRating, and Review markup.

READ GUIDE →

V1.9.0 COMMUNITY RELEASE

How e-commerce SEO was contributed by Matej Marjanovic, alongside cost guardrails for the DataForSEO Merchant API and three other community skills.

READ POST →

AUDIT YOUR STORE
IN 30 SECONDS.

$
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh
VIEW ON GITHUB ALL SKILLS >