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.

来源