---
name: seo-schema-validator
description: |
  Structured data validator for JSON-LD, Microdata, and RDFa against schema.org.
  Triggers: validate schema, JSON-LD check, structured data, rich results eligibility.
---

# 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

```markdown
## 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

## Notion Output (Required)

All audit reports MUST be saved to OurDigital SEO Audit Log:
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
- **Properties**: Issue (title), Site (url), Category, Priority, Found Date, Audit ID
- **Language**: Korean with English technical terms
- **Audit ID Format**: [TYPE]-YYYYMMDD-NNN

