Schema Validator Build Time

Validate JSON-LD schema markup at build-time with Rich Results API integration, duplicate…

Validates JSON-LD schema markup at build-time and turns your CI/CD pipeline into a deploy gate, so broken structured data never reaches production. It combines schema.org spec compliance, Google Rich Results eligibility checks, and a duplicate-entity detector that catches the multiple-AggregateRating mistake that silently kills star ratings in search. Instead of finding schema errors weeks later in a live audit, you catch them in seconds before merge.

$15 one-time
Add to a kit →

Prices include 20% VAT. · Forged on real agency work · one-time, no lock-in

  • Type Skill
  • Category Search & AEO
  • Delivery Email · instant
  • License One-time
Run preview
forgehouse, schema-validator-build-time

Inside the run · no black box

See the actual work before you buy it.

The skill is a build-time deploy gate for JSON-LD: it scans the built HTML, validates every schema block against the spec and Google's Rich Results API, hunts duplicate entities and broken nested references, and fails the build on CRITICAL errors before production ever sees them.

  1. Hooks into the build: after next build, a post-build script walks the output HTML and extracts every application/ld+json block, and a JSON parse error in a block itself counts as CRITICAL.
  2. Checks the cache first: each schema's SHA256 hash maps to a 24 hour cached verdict, so on a 1000 plus page site the second build validates in under 10 seconds with cache hit rates around 85 percent.
  3. Validates uncached schemas against the schema.org spec and the Rich Results API with retry and exponential backoff; if the API is unreachable it degrades to spec-only checks instead of failing the whole pipeline.
  4. Runs the duplicate entity detector: it walks the entire JSON tree counting singleton types like AggregateRating, and more than one instance returns a CRITICAL error listing the exact JSON paths plus a merge remediation.
  5. Validates nested composition: an Article author must be a Person with a name, the publisher must be an Organization with a logo, @id references must resolve, and a missing sameAs is flagged because AI bots need it for entity linking.
  6. Applies the severity gate: CRITICAL exits with code 2 and blocks the deploy, MEDIUM logs warnings, LOW becomes a PR comment; the GitHub Actions check is required before anything merges to main.
Use cases · what happens when you plug it in

One power source. 6 lines out.

schema-validator-build-time · core

core active · 6 lines

  1. Add a schema validation gate to a Next.js, Astro, or Nuxt build

    ✓ add a schema validation
  2. Catch duplicate AggregateRating before it kills your star ratings

    ✓ catch duplicate aggregat…
  3. Validate 1000+ pages of multilingual SSG schema in one CI run

    ✓ validate 1000+ pages of
  4. Diagnose why rich results or AI citations stopped appearing

    ✓ diagnose why rich results
  5. Enforce a required check on main before merge

    ✓ enforce a required check
  6. Verify nested Article to Person to Organization @id integrity

    ✓ verify nested article to
Benefits · what you walk away with

Yours to keep.

Drag time forward. Watch what stays.

Forever

That's what owning means.

The rented stack

ai writing tool: subscription

expired · access lost

analytics suite: subscription

expired · access lost

design platform: subscription

expired · access lost

(nothing left)

Your forge

  1. Stop invalid schema from ever reaching production with a hard build-fail

    license: perpetual
  2. Recover from costly star-rating loss before it happens, not 4-8 weeks after

    license: perpetual
  3. Validate thousands of pages in under a minute via hash-based caching

    license: perpetual
  4. Get exact file, line, JSON path, and fix instruction for every error

    license: perpetual

subscriptions expire · deeds don't

What's included · the full manifest

Everything in the box.

Pick a piece up. Watch it work.

Python async validator wrapping Google Rich Results API with retry and rate-limit handling

part 01 of 06 · in the box

6 parts · one working system · ships instantly by email

From the field · a real case

This wasn’t written at a desk.

The problem

The fix

The result

Who it's for

This wasn't forged for everyone.

  • Not for you if you'd rather rent a tool than own one.
  • Not for you if you want someone else to run your stack.
  • Not for you if you're happy guessing.
Still here? Good.

For developers and SEO engineers running schema-rich sites who need structured-data errors blocked at build-time rather than discovered live.

then this was forged for you.

Works with

Universal by design: these run in any AI. Delivered in the open Agent Skills + MCP format (native in Claude); ChatGPT, Gemini, Cursor and Copilot adapt the same files their own way.

  • Claude Native format
  • ChatGPT Adapts via open standards
  • Gemini Adapts via open standards
  • Cursor Adapts via open standards
  • Copilot Adapts via open standards
Questions · still in the air

Catch what's on your mind.

the air is clear. nothing between you and the forge.
catch a spark: the forge will answer

  1. We're on Nuxt rather than Next.js, does the deploy gate still apply?

    Yes. The validator scans rendered HTML for JSON-LD blocks, so any SSG output works; Next.js, Astro, and Nuxt are the documented setups. The GitHub Actions workflow with CRITICAL/MEDIUM/LOW severity thresholds is framework-agnostic.

  2. How is this better than pasting pages into the Rich Results Test by hand?

    It wraps the same Rich Results checks in an async validator that covers 1000+ pages in one CI run, and adds what the manual tool won't batch: a duplicate-entity detector for the multiple-AggregateRating mistake and nested @id integrity checks. A 24-hour SHA256 hash cache keeps repeat builds under 10 seconds.

  3. Will it fix the schema errors it finds?

    No. It blocks the deploy and reports the exact file, line, JSON path, and a fix instruction for every error, but writing the correction is on you. It's a gate, not an autofixer.

  4. How is it delivered?

    By email right after purchase: ready to run, downloaded instantly, no setup wait.

  5. One-time or subscription?

    A one-time purchase; no subscription or hidden fees. VAT (20%) is included.

  6. Can I get a refund?

    As a digital product, it can’t be refunded once downloaded. That’s why we show exactly what’s inside and who it’s for, right here.