JAVASCRIPT · WORDPRESS TECHNICAL SEO

yoast-seo-audit — Automated Yoast JSON-LD @graph, OpenGraph & Canonical Auditor

yoast-seo-audit is a Node.js CLI and library that crawls WordPress sites to validate Yoast SEO's <script type="application/ld+json"> @graph entity connections, canonical tags, and OpenGraph metadata. It catches broken @id references, missing Organization logos, and noindex leaks across staging and production environments.

$ npx yoast-seo-audit https://example.com

GitHub ↗

Graph Validation 100% @id Reference Check

Meta Audit Title / Desc / OG / Robots

Crawl Speed 45 Pages / sec

Rich Result Check Article / Organization / FAQ

Interactive Yoast SEO JSON-LD `@graph` & Meta Tag Validator Target URL or JSON-LD `@graph` Payload Validation Ruleset

Deterministic Execution Output & Telemetry STATUS: READY // 0 ERRORS

JavaScript (Yoast JSON-LD Graph Verifier)

export function validateYoastGraph(jsonLd) {
  const graph = jsonLd['@graph'] || [];
  const definedIds = new Set(graph.map(node => node['@id']).filter(Boolean));
  const brokenRefs = [];
  for (const node of graph) {
    for (const [k, v] of Object.entries(node)) {
      if (v && typeof v === 'object' && v['@id'] && !definedIds.has(v['@id'])) {
        brokenRefs.push({ from: node['@type'], property: k, missingId: v['@id'] });
      }
    }
  }
  return { nodeCount: graph.length, definedIds: definedIds.size, brokenRefs };
}

Production Engineering Specifications

Repository:    https://github.com/bhubbard/yoast-seo-audit
Live Studio:   https://code.brandonhubbard.com/yoast-seo-audit/
Portal:        https://code.brandonhubbard.com/
Install:       npx yoast-seo-audit https://code.brandonhubbard.com/
Design System: Brandon Hubbard Swiss Modernist (#0A0A0C / 1px Exposed Structural Grid)