Technical SEO

Structured Data Validator

/sd-validate

Validate JSON-LD structured data on any page against schema.org specs and Google's rich result requirements. Catches errors before they cost you rich snippets.

Get this skill

Install all free SEO skills with one command:

curl -fsSL https://raw.githubusercontent.com/ccforseo/seo-skills/main/install.sh | bash

Or install this skill manually:

$ git clone https://github.com/ccforseo/seo-skills.git
$ cp -r seo-skills/structured-data-validator ~/.claude/skills/structured-data-validator
View on GitHubFree · MIT License · 8 skills included

What it does

The Structured Data Validator skill tests your JSON-LD markup against schema.org specifications and Google's rich results requirements. It parses every structured data block on a page, validates required and recommended properties, checks data types and value formats, and confirms the markup qualifies for Google rich results like FAQ dropdowns, star ratings, and product cards.

Key features

  • Validates JSON-LD against schema.org and Google requirements
  • Checks all required and recommended properties per type
  • Verifies data types, URL formats, and date formats
  • Confirms rich result eligibility (FAQ, Product, Review, etc.)
  • Batch validates multiple pages from a URL list

How to use Structured Data Validator

  1. Run the command

    Type /sd-validate with a page URL or paste your JSON-LD code directly. The skill parses and validates all structured data found.

  2. Review errors and warnings

    The output separates critical errors (blocks rich results) from warnings (missed opportunities). Each issue includes the property path and expected format.

  3. Fix and revalidate

    Correct the flagged issues in your markup and run the command again to confirm everything passes.

When to use it

Validating schema after changes to page templates

Pre-launch check for rich result eligibility

Debugging why rich snippets stopped appearing in SERPs

Batch validation of schema across product catalog pages

Frequently asked questions

What is the difference between schema.org validation and Google validation?

Schema.org defines the full vocabulary of types and properties. Google only supports a subset for rich results and has stricter requirements. The skill checks both, so your markup is technically correct and eligible for Google's rich result features.

Can the Structured Data Validator check microdata or RDFa?

The skill focuses on JSON-LD, which is Google's recommended format. If your site uses microdata or RDFa, consider migrating to JSON-LD for better compatibility and easier maintenance.

How do I know if my schema qualifies for rich results?

The skill explicitly states whether your markup meets Google's rich result requirements for each schema type. It lists which rich result features your markup enables, such as FAQ dropdowns, review stars, or product cards.

Can I validate structured data for multiple pages at once?

Yes. Provide a list of URLs or a sitemap, and the skill validates structured data on every page. The batch report summarizes issues by page and by error type for efficient remediation.

Related skills

Technical SEO

Schema Generator

/schema-gen

Generate valid JSON-LD structured data for any page type. Supports Article, Product, FAQ, LocalBusiness, HowTo, and 20+ other schema types.

Technical SEO

Site Audit

/seo-audit

Run a full technical SEO audit from your terminal. Checks crawlability, indexation issues, meta tags, page speed signals, and site structure in one pass.

Local SEO

Local Business Schema

/local-schema

Generate LocalBusiness JSON-LD schema markup with all recommended properties. Includes opening hours, service areas, accepted payments, and department details.

AI Visibility

AEO Content Formatter

/aeo-format

Format your content for Answer Engine Optimization. Restructures pages with citation blocks, entity definitions, and structured answer patterns that AI engines extract.

Get all 50 skills

The SEO Command Center includes every skill in this library plus Python data fetchers, CLAUDE.md configs, and report templates. One-time purchase.

Browse all skills