Contact
Open source · Content & Publishing

Social Card Metadata Checker

Check social title, image, alt text and description alignment with article identity.

v1.0.0 · Node.js 22+ · MIT

Browse the public repository · View releases

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+.

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 check

Read 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.