I built a zero-dependency CLI that crawls your site and lints its JSON-LD

Описание и применение

CLI‑инструмент без зависимостей, который сканирует сайт, извлекает JSON‑LD и проверяет его на ошибки, интегрируется в CI.

Задача

Structured data errors often go unnoticed because they don't break page rendering, yet they harm SEO and rich results. Existing tools test only single URLs, making site-wide audits cumbersome for CI pipelines.

Результат

The tool provides fast, zero‑dependency audits of JSON‑LD across entire sites, catching common errors (invalid JSON, missing context/type, property omissions, value sanity, duplicates, and missing structured data) and integrating seamlessly into CI pipelines.

Рабочий процесс

• 1. Run node schema-audit.mjs https://example.com/ to audit a live site. 2. Use --sitemap https://example.com/sitemap.xml to crawl all pages. 3. Optionally run npm run demo for an offline demo with seeded issues. 4. Review the human report or use --json for machine‑readable output. 5. Configure CI to run the CLI weekly and fail the build if exit code indicates errors.
• 6. Fix reported issues in the site’s JSON‑LD and re‑run the audit to confirm resolution.

Доказательства

It extracts every ld+json block (including @graph and nested entities) and runs 9 checks: JSON validity, @context/@type presence, required and recommended properties, value sanity, duplicate entities and pages with no structured data at all.

Источник