our-claude-skills/custom-skills/13-seo-schema-validator/desktop/SKILL.md

name: seo-schema-validator version: 1.0.0 description: Structured data validator for JSON-LD, Microdata, and RDFa. Triggers: validate schema, structured data, JSON-LD, rich results, schema.org. allowed-tools: mcp__firecrawl__, mcp__perplexity__

SEO Schema Validator

Purpose

Extract and validate structured data (JSON-LD, Microdata, RDFa) against schema.org vocabulary and Google Rich Results requirements.

Core Capabilities

1. Extract - Find all structured data on page
2. Parse - JSON-LD, Microdata, RDFa formats
3. Validate - Schema.org compliance
4. Rich Results - Google eligibility check

MCP Tool Usage

mcp__firecrawl__scrape: Extract page HTML with structured data
mcp__perplexity__search: Research schema requirements

Workflow

1. Scrape target URL
2. Locate structured data blocks
3. Parse each format found
4. Validate against schema.org
5. Check Rich Results eligibility
6. Report issues and recommendations

Supported Schema Types

Type	Required Properties	Rich Result
Article	headline, author, datePublished, image	Yes
Product	name, offers (price, availability)	Yes
LocalBusiness	name, address, telephone	Yes
FAQPage	mainEntity (questions)	Yes
Organization	name, url, logo	Sitelinks
BreadcrumbList	itemListElement	Yes
WebSite	name, url, potentialAction	Sitelinks
Review	itemReviewed, reviewRating	Yes
Event	name, startDate, location	Yes
Recipe	name, image, ingredients	Yes

Validation Levels

Level 1: Syntax

• Valid JSON structure
• Proper nesting
• No parsing errors

Level 2: Vocabulary

• Valid @type values
• Known property names
• Correct value types

Level 3: Rich Results

• Required properties present
• Recommended properties
• Google-specific requirements

Output Format

## Schema Validation: [URL]

### Schemas Found: X

#### Schema 1: [Type]
- Format: JSON-LD
- Valid: Yes/No
- Rich Results Eligible: Yes/No

**Issues:**
- [Error/Warning list]

**Properties:**
| Property | Present | Valid |
|----------|---------|-------|

### Summary
- Valid: X
- Invalid: X
- Rich Results Ready: X

### Recommendations
1. [Fixes needed]

Common Issues

Issue	Severity	Fix
Missing required property	Error	Add property
Invalid date format	Error	Use ISO 8601
Missing @context	Error	Add schema.org context
No image property	Warning	Add image URL

Limitations

• Cannot test rendered schema (JavaScript)
• Validation against schema.org, not all Google features
• Use Google Rich Results Test for final verification