// SKILL

SCHEMA MARKUP
DETECT. VALIDATE. GENERATE.

Detect, validate, and generate Schema.org structured data in JSON-LD format. Validates against Google's supported rich result types. Flags deprecated schemas like HowTo (removed September 2023) and SpecialAnnouncement (deprecated July 2025). Generates ready-to-use JSON-LD with all required and recommended properties.

$

/seo schema https://your-site.com

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

// HOW IT WORKS

THREE-PHASE ANALYSIS.

When you run /seo schema, Claude SEO performs a three-phase analysis: detection, validation, and generation. It scans the page source for all three Schema.org formats, validates each block against Google's current requirements, and then generates any missing schema types that would benefit your page.

Per Google's December 2025 JavaScript SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup, especially Product and Offer schemas, the tool recommends including JSON-LD in the initial server-rendered HTML.

What gets checked

The schema analysis covers detection of all three formats, validation against Google's current supported types, and generation of missing schema opportunities. It always recommends JSON-LD as the primary format, which is Google's stated preference.

3
FORMAT DETECTION
Scans for JSON-LD (script type application/ld+json), Microdata (itemscope, itemprop), and RDFa (typeof, property). Always recommends JSON-LD as Google's preferred format.

6

VALIDATION CHECKS

Checks for missing @context, invalid @type, wrong data types, placeholder text, relative URLs (should be absolute), and invalid date formats. Flags every issue with a fix.

20+

ACTIVE SCHEMA TYPES

Organization, LocalBusiness, SoftwareApplication, Product, Article, BlogPosting, Review, AggregateRating, BreadcrumbList, WebSite, Person, VideoObject, Event, JobPosting, Course, and more.

7+

DEPRECATED DETECTION

Flags HowTo (Sept 2023), SpecialAnnouncement (July 2025), CourseInfo, EstimatedSalary, LearningVideo (June 2025), ClaimReview (June 2025), VehicleListing (June 2025), and more.

1

RESTRICTED TYPE

FAQ schema is restricted to government and healthcare authority sites only since August 2023. The tool flags this when FAQ schema is detected on non-qualifying sites.

3

READY TEMPLATES

Generates complete JSON-LD for Organization, LocalBusiness, and Article/BlogPosting with all required and recommended properties. Includes only truthful, verifiable data.

// SCHEMA STATUS

CURRENT TYPE STATUS (FEB 2026)

Google regularly updates which schema types produce rich results. Claude SEO tracks these changes so you never waste time implementing deprecated markup or miss new opportunities.

Active types (recommend freely)

Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup as of April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting.

Deprecated types (never recommend)

Type	Status
HowTo	Rich results removed September 2023
FAQ	Restricted to gov/healthcare since August 2023
SpecialAnnouncement	Deprecated July 2025
CourseInfo, EstimatedSalary, LearningVideo	Retired June 2025
ClaimReview	Retired from rich results June 2025
VehicleListing	Retired from rich results June 2025
Practice Problem, Dataset	Retired from rich results late 2025

// USAGE

HOW TO RUN A SCHEMA ANALYSIS

Step 1: Install Claude SEO

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Step 2: Open Claude Code

claude

Step 3: Run the schema analysis

/seo schema https://your-site.com

The tool detects all existing schema, validates each block, and generates ready-to-use JSON-LD for any missing types. You get two output files: a detection/validation report and generated schema code.

Output files

SCHEMA-REPORT.md - detection results, validation status for each schema block, and recommendations for missing schema types
generated-schema.json - ready-to-use JSON-LD snippets that you can copy directly into your HTML

// FAQ

QUESTIONS ABOUT SCHEMA MARKUP

Which schema formats does Claude SEO detect?

-

Claude SEO detects all three Schema.org formats: JSON-LD (script type application/ld+json), Microdata (itemscope, itemprop attributes), and RDFa (typeof, property attributes). It always recommends JSON-LD as the primary format since it is Google's stated preference.

As of February 2026, several schema types are deprecated: HowTo (rich results removed September 2023), SpecialAnnouncement (deprecated July 2025), CourseInfo/EstimatedSalary/LearningVideo (retired June 2025), ClaimReview (retired from rich results June 2025), VehicleListing (retired June 2025), Practice Problem (retired late 2025), and Dataset (retired late 2025). FAQ is restricted to government and healthcare authority sites only since August 2023.

Both. Claude SEO first detects and validates existing schema on a page, checking required properties, data types, URL formats, and date formats. Then it identifies missing schema opportunities based on your page content and generates valid JSON-LD with all required and recommended properties, ready to copy into your HTML.

Per Google's December 2025 JavaScript SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup, especially Product and Offer schemas, Google recommends including JSON-LD in the initial server-rendered HTML rather than injecting it with JavaScript.

Active types include Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup since April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, VideoObject, ImageObject, Event, JobPosting, Course, and DiscussionForumPosting, among others.

// RELATED SKILLS

EXPLORE MORE

VIEW ALL 14 SKILLS →

SCHEMA MARKUPDETECT. VALIDATE. GENERATE.