seo-ecommerce

E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps. Combines on-page product SEO with marketplace data from DataForSEO Merchant API. Use when user says "ecommerce SEO", "product SE

By agricidaniel · 4,625 installs

npx skills add agricidaniel/claude-seo --skill seo-ecommerce

Source repository · Upstream listing

E commerce SEO Analysis Comprehensive product page optimization, marketplace intelligence, and competitive pricing analysis. Works standalone (on page + schema) and with DataForSEO Merchant API for live Google Shopping and Amazon data. Commands Command Purpose DataForSEO? /seo ecommerce <url Full e commerce SEO analysis of a product page or store Optional /seo ecommerce products <keyword Google Shopping competitive analysis Required /seo ecommerce gaps <domain Keyword gap: organic vs Shopping visibility Required /seo ecommerce schema <url Product schema validation and enhancement No 1. Product Page Analysis (No DataForSEO Needed) Fetch and parse any product page for on page SEO quality. Workflow Product SEO Checklist Title Tag [ ] Contains primary product keyword [ ] Includes brand name [ ] Under 60 characters (no truncation in SERPs) [ ] Format: [Product Name] [Key Feature] [Brand] Meta Description [ ] Contains product keyword + benefit [ ] Includes price or "from $XX" (triggers rich snippet interest) [ ] Call to action present (Shop now, Buy, Free shipping) [ ] Under 155 characters Heading Structure [ ] Single H1 matching primary product name [ ] H2s for: Features, Specifications, Reviews, Related Products [ ] No duplicate H1 tags across product variants Product Images [ ] Alt text includes product name + distinguishing feature [ ] File names are descriptive (not IMG 001.jpg ) [ ] WebP format served (with JPEG fallback) [ ] At least 3 images per product (hero, detail, lifestyle) [ ] Image dimensions = 800px for Google Shopping eligibility [ ] Lazy loading on below fold images only Internal Linking [ ] Breadcrumb navigation: Home Category Subcategory Product [ ] Related products section (cross sell / upsell) [ ] Link back to category page with keyword rich anchor [ ] Reviews section links to full review page (if separate) Content Quality [ ] Unique product description (not manufacturer copy paste) [ ] Word count = 200 for product description body [ ] Specs table present (not just prose) [ ] User reviews on page (UGC signals) Scoring Category Weight Criteria Schema completeness 25% Required + recommended Product fields Title & meta 15% Keyword placement, length, format Image optimization 20% Alt text, format, sizing, count Content quality 20% Unique description, specs, reviews Internal linking 10% Breadcrumbs, related products, categories Technical 10% Page speed, mobile rendering, canonical 2. Google Shopping Intelligence (DataForSEO Merchant API) Live competitive analysis from Google Shopping results. Cost Guardrail (MANDATORY) Before EVERY Merchant API call: "status": "approved" proceed "status": "needs approval" show cost, ask user "status": "blocked" stop, inform user After each call: Workflow Analysis Outputs Pricing Intelligence Price distribution: min, max, median, P25, P75 Price outliers ( 2 standard deviations from median) Price to rating correlation Currency normalization to USD (or user specified) Seller Landscape Top 10 sellers by listing count Merchant rating distribution Free shipping prevalence New vs established sellers Product Listing Quality Title keyword patterns in top listings Average rating and review count benchmarks Image count per listing Availability status distribution Load references/marketplace endpoints.md for full API parameter details. 3. Amazon Marketplace (DataForSEO) Cross marketplace intelligence comparing Google Shopping and Amazon. Cost Guardrail (MANDATORY) Amazon endpoints are in the warn endpoints set always requires user approval. Workflow Cross Marketplace Report Metric Google Shopping Amazon Avg price $ $ Median rating X.X X.X Avg review count N N Top seller share % % Free shipping % % % 4. Marketplace Keyword Gaps Identify mismatches between organic and Shopping visibility. Workflow 1. Fetch organic rankings via seo dataforseo: dataforseo labs google ranked keywords for domain 2. Fetch Google Shopping presence via Merchant API: merchant google products search for top organic keywords 3. Cross reference results Gap Types Gap Type Meaning Action Organic Only Ranks organically but no Shopping ads Create Google Merchant Center feed, bid on these keywords Shopping Only Shopping visibility but weak/no organic Create content (buying guides, comparison pages) for these keywords Both Present Visible in both channels Optimize: ensure price consistency, enhance schema Neither No visibility in either Low priority unless high volume Output Format 5. Product Schema Enhancement Validate and generate Product schema following Google's current requirements. Confirmed Required Properties (Google Merchant) Confirmed required fields are name , image , and offers ; use Offer , not AggregateOffer , for merchant listings. Recommended Properties (Enhance Rich Results) sku product identifier description , brand , offers.seller recommended context fields gtin13 / gtin14 / mpn global trade identifiers aggregateRating star rating + review count review individual reviews (minimum 1) color , material , size variant attributes shippingDetails ShippingDetails with rate and delivery time (merchant level shipping via ShippingService is also supported; shipping/returns can be set in Search Console without a Merchant Center account) hasMerchantReturnPolicy MerchantReturnPolicy with type and days hasAdultConsideration required for adult oriented products (added 2026 05 20 to Product variant / Merchant listing); Google Search supports only the value https://schema.org/SexualContentConsideration category Text , CategoryCode , or an array mixing both. Use custom text for merchant defined product types and CategoryCode with Google's taxonomy URL plus codeValue for Google Product Categories. Validation Rules 1. price must be a number string, not "$29.99" (no currency symbol) 2. availability must use full Schema.org URL enum 3. image should be array with = 1 high res image URL 4. priceCurrency must be ISO 4217 (USD, EUR, GBP) 5. If brand is present, brand.name must not be empty or "N/A" 6. Sale periods use validFrom plus either validThrough or priceValidUntil , in ISO 8601 format. Include time and timezone when known. 7. If aggregateRating present: ratingValue and reviewCount required 8. Do not include fake reviews or undisclosed incentivized reviews in visible content or structured data. Clearly and prominently disclose incentives. Schema Scoring Completeness Score All required fields 50/100 + aggregateRating 65/100 + sku/gtin/mpn 75/100 + shippingDetails 85/100 + merchantReturnPolicy 90/100 + reviews (3+) 100/100 Cross Skill Integration Skill Integration Point seo schema Delegates Product schema generation; reuses validation logic seo images Product image audit (alt text, format, dimensions), plus DigitalSourceType: TrainedAlgorithmicMedia IPTC label for AI generated product images (Merchant Center requirement) seo content Product description E E A T and uniqueness analysis seo dataforseo Organic keyword rankings for gap analysis seo technical Core Web Vitals for product pages (LCP on hero image) seo hreflang Region specific result units: product queries in the EEA, South Africa, and Turkiye can show supplier units and carousels with their own eligibility rules (documented 2026 09 08) seo google GSC indexation + Performance data for product URLs (NOT Merchant Center feed validation, that is done in Merchant Center / the Merchant API ; the legacy Content API for Shopping sunsets 2026 08 18) UCP: Universal Commerce Protocol (live) Google initiated open standard (co developed with Shopify, Etsy, Wayfair, Target, Walmart; payment partners Visa/Mastercard/Stripe/Adyen/Amex) for letting AI agents discover, negotiate, and transact with merchants without one off integrations. Google confirms a first reference implementation for conversational buying in AI Mode in Search. Broader Universal Cart rollout details are reported from Google I/O 2026 keynote coverage; not confirmed on a Google owned source. ucp.dev lists 2026 04 08 as the latest release in its date based versioning scheme, not 1.0 ; two integration paths: Native (default) and Embedded (approved merchants). Pairs with AP2 (reportedly moving toward FIDO governance). Canonical: developers.google.com/merchant/ucp and ucp.dev. Merchants already on Google Merchant Center with clean Product schema can declare a UCP profile at /.well known/ucp listing capabilities ( dev.ucp.shopping.checkout , .fulfillment , .discount ). See references/ucp universal commerce protocol.md for audit criteria, capability examples, and the relationship to AP2 (Agent Payments Protocol). Audit command The script returns: profile presence, version, declared capabilities, structural issues (missing fields, unknown capability IDs), and (with probe endpoints ) per endpoint reachability. SSRF blocked endpoints are reported explicitly. Missing profile is reported as opportunity, not failure. UCP itself is live; what's early is broad merchant adoption. Flag a literal "version": "1.0" as invalid (UCP versions are date based, e.g. 2026 04 08 ). Error Handling Error Cause Response No Product schema found Page lacks JSON LD Analyze page content, generate recommended schema DataForSEO credentials missing Env vars not set Run analysis without marketplace data, note limitation Cost check blocked Daily budget exceeded Inform user, offer free only analysis Empty Shopping results No products for keyword Suggest broader keyword, check location settings Amazon API timeout Network/rate limit Retry with backoff, fall back to Google only Invalid URL Malformed input Validate via google auth.validate url() , show error Non product page URL is category/homepage Detect page type, suggest /seo ecommerce schema instead Output Template