An offline, read-only comparison of exported article identity records and their exported social cards. It checks exact title, description, image path and image alt text, plus the presence of referenced local image files. It never fetches URLs, decodes images, renders a browser, or publishes a card. Node.js 22+; no dependencies.
This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.
Run the checked-in example
node bin/social-card-metadata-checker.mjs --root examples/passing --input manifest.json
node bin/social-card-metadata-checker.mjs --root examples/failing --input manifest.json
npm run checkRead the result
The first exits 0; the second exits 1 with article-to-card field mismatches. --human emits a short stderr summary. --out report.json additionally writes the same stdout JSON report inside the root. Invalid options and refused output destinations exit 2 with empty stdout. Unreadable input emits an incomplete JSON report and exits 2.
Where this check stops
This local walkthrough does not establish the state of a live production system or replace the limits documented in the repository.
Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.
Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.