// SKILL REFERENCE

E-COMMERCE SEO
PAGE EVIDENCE + MARKETPLACE RESEARCH

Audit product-page evidence, validate Product structured data, research Google Shopping listings, and compare organic visibility with Shopping presence using the reviewed Claude SEO command surface.

By Daniel Agrici · Page updated: 2026-08-27 · Command surface verified: 2026-08-26

CONTRIBUTED BY MATEJ MARJANOVIC · PRO HUB CHALLENGE · original repo

$

/seo ecommerce https://your-store.com

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

// RUN PREVIEW

What will happen if you start this skill?

Readiness depends on the command path. Page and schema reviews can use local evidence, while products and gaps require DataForSEO credentials, a location-aware request, and a cost check.

OUTCOME

Product-page or schema findings, plus a marketplace snapshot only when the paid path is selected.

REQUIRED INPUT

A URL for page or schema review, a keyword for products, or a domain for gaps.

READINESS

URL and schema paths can run without DataForSEO. Products and gaps require its paid Merchant API.

OUTPUT

Observed evidence, structured-data findings, available provider data, prioritized actions, and explicit limitations.

SIDE EFFECTS

Fetches the target page. Paid paths also send a provider request and record the request in the local budget ledger.

COST + APPROVAL

Run the cost guardrail before paid Merchant API work. Amazon helper requests always need explicit approval.

Listen to the e-commerce summary

A 60-second spoken orientation to the local and paid e-commerce command paths, their inputs, outputs, costs, and limitations.

1:00 AUDIO

AI-generated narration using Daniel's authorized voice at 1.1x. The user-supplied music bed is mixed at 0.02 linear gain with short fades. An integrated-loudness comparison measures the speech stem 23.5 LU above the music stem. We use a 20 LU internal mix target as an engineering proxy. W3C's low-background-audio guidance defines a separate 20 dB conformance option, so this proxy does not establish WCAG conformance. Daniel approved the complete audio and music balance on 2026-08-27.

// CHOOSE THE RIGHT PATH

What should this skill be used for?

Use the local paths for product-page and structured-data evidence. Add paid marketplace data only when the question needs it and the cost check is approved.

START HERE

Review a page or store

Use the URL command for page content, product evidence, images, internal paths, and visible structured data. Its core review does not require DataForSEO.

NARROW CHECK

Inspect Product markup

Use the schema command when the question is limited to Product and Offer property coverage, truthful correction recommendations, and Google eligibility guidance.

PAID RESEARCH

Add marketplace snapshots

Products and gaps use the paid DataForSEO Merchant API. They require credentials, a location-aware request, and the workflow's cost guardrail.

DO NOT USE IT FOR

Account-state validation

The skill does not inspect Merchant Center or Seller Central accounts. It cannot prove approval, inventory state, rankings, traffic, or sales.

// COMMAND SURFACE

Which e-commerce commands are available?

SOURCE VERIFIED: 2026-08-26

Four public commands

Command	Use it for	DataForSEO
`/seo ecommerce <url>`	Product-page or store analysis, with optional marketplace evidence	Optional
`/seo ecommerce products <keyword>`	Location-specific Google Shopping product research	Required
`/seo ecommerce gaps <domain>`	Compare organic keyword visibility with Shopping presence	Required
`/seo ecommerce schema <url>`	Product and Offer structured-data review	No

Command correction: older page copy listed dedicated Shopping, Amazon, and pricing subcommands. They are not part of the reviewed public command surface. Amazon data remains an internal provider helper and every Amazon request requires explicit approval.

Representative sequence

/seo ecommerce https://shop.example.com/product/example
/seo ecommerce schema https://shop.example.com/product/example
/seo ecommerce products "running shoes"
/seo ecommerce gaps shop.example.com

The first two examples can run without DataForSEO. The last two should stop before a paid request until credentials and the cost decision are available. These are command examples, not claimed results.

// WORKFLOW + BOUNDARIES

What happens after you run a command?

Resolve the input. The skill works from a URL, keyword, or domain, depending on the selected command.
Inspect page evidence. URL paths review the accessible product content, images, internal paths, and visible Product or Offer markup.
Check paid access. Marketplace paths require DATAFORSEO_USERNAME and DATAFORSEO_PASSWORD, followed by the cost guardrail before any request.
Collect a provider snapshot. When approved, DataForSEO can return Google Shopping or internal Amazon helper results for a chosen location and language.
Separate findings from limits. The output should distinguish observed page evidence, structured-data issues, provider data, recommended actions, and unknowns.

Cost and permission boundary

Claude SEO is MIT licensed, but paid provider calls are not free. The products and gaps commands require the optional DataForSEO extension. The full URL command can use that extension, while the schema command does not need it. The workflow must check the configured daily budget before each Merchant API request. Amazon endpoints are warning endpoints in the pinned guardrail and always require explicit approval.

The cost guardrail reads or writes ~/.config/claude-seo/dataforseo-costs.json and ~/.config/claude-seo/dataforseo-ledger.json. Review the configured budget before a paid call, and do not publish either local file.

Failure behavior

Condition	Documented response
Invalid or non-product URL	Reject malformed input. For a category or homepage, identify the page type and suggest the schema path.
No Product schema	Analyze available page content and recommend markup instead of claiming validation success.
Missing DataForSEO credentials	Continue without marketplace data and label the limitation.
Blocked cost check	Stop the paid request and offer the page-only analysis.
Empty Shopping results	Suggest a broader keyword and re-check location settings.
Amazon provider timeout	Retry with backoff, then fall back to Google-only evidence.

Outputs

Page and visible structured-data findings for the supplied URL
Product or Offer property findings and truthful correction recommendations
Marketplace snapshots only when the paid path is configured and approved
A prioritized action list with evidence, source, and limitation labels

What the result cannot prove

Valid Product markup can create eligibility for richer search appearances, but it does not guarantee that Google will show one. Provider snapshots are not first-party Merchant Center or Seller Central truth. Marketplace results can vary by location, language, and collection time. No live marketplace request was made for this page update.

// VERIFIED SOURCES

What is this reference based on?

Reviewed e-commerce skill source, public commands, workflow, outputs, and provider boundaries.
Reviewed commands reference, exact syntax and examples.
Google Product structured data documentation, product appearances and the relationship between markup and Merchant Center feeds.
Google merchant listing documentation, Product and Offer eligibility requirements.
DataForSEO Merchant API overview, paid task-based Google Shopping and Amazon data.

Source review completed on 2026-08-26. Product and provider requirements can change, so re-check the linked primary documentation before a consequential implementation.

// FAQ

What should you know before running it?

Which e-commerce command should I start with?

Start with /seo ecommerce <url> for a product page or store review. It can inspect the page without DataForSEO and add marketplace evidence only when the optional extension and approval are available.

Which e-commerce commands require DataForSEO?

What does the Product schema command verify?

Is Amazon a separate e-commerce subcommand?

Does the skill guarantee Shopping visibility?

// RELATED SKILLS

EXPLORE MORE

VIEW ALL 25 SKILLS →

E-COMMERCE SEOPAGE EVIDENCE + MARKETPLACE RESEARCH