Open Graph Social Card Auditor
Check the social-card metadata in HTML you supply before a missing value or relative image URL becomes a broken share preview.
What it inspects
- Individual
.htmlor.htmfiles. - Folders, recursively limited to HTML documents.
- Pasted markup supplied through
--stdin.
The included Python scanner uses the standard library, reads only the scope you supply, and returns structured findings with a rule ID, severity, file, line, and message. It does not modify the HTML.
The eight static checks
- Missing values for
og:title,og:image,og:description,og:url, ortwitter:card. - A relative or scheme-less
og:imageortwitter:imageURL. - An SVG image URL, reported as a low-severity portability review rather than a universal failure.
- Missing or non-
1200x630Open Graph dimensions, reported at informational severity.
The rule set combines Open Graph basics with common LinkedIn and X/Twitter share metadata. That makes it a preflight, not a claim that every field has the same status on every platform.
A representative finding
Each result is something to review against the platform you care about. Medium findings make the command exit nonzero; low and informational findings do not.
Dimension and format findings are intentionally cautious
1200x630 is the scanner's common cross-platform preset, not a universal law. LinkedIn currently recommends a 1.91:1 ratio and lists 1200x627 as the minimum for its sharing module. Likewise, the SVG rule signals portability risk; it does not claim that every platform rejects every SVG.
The editable local rule table lets a team see the preset being applied. The package does not download an image and confirm its real dimensions, MIME type, file size, or pixel contents.
Boundaries and limitations
This is a static markup audit. It does not fetch a production URL, follow redirects, render client-side metadata, test whether a crawler can reach the image, inspect platform debugger output, or refresh a cached preview.
A clean report means the supplied HTML passed the configured checks. It cannot guarantee that LinkedIn, X, Facebook, Slack, or another consumer will render the same preview.
Troubleshoot the live LinkedIn layer separately
The guide shows how to compare Open Graph's basic metadata with LinkedIn's current requirements, test the final page and image URLs, distinguish 1200x630 from LinkedIn's stated minimum, and refresh a stale cache only after the live inputs are correct.
Questions
What does Open Graph Social Card Auditor inspect?
It reads HTML files, folders of HTML files, or head markup supplied through stdin and checks the parsed meta tags. It does not inspect image bytes or a browser-rendered DOM.
Which metadata problems does it flag?
It flags missing og:title, og:image, og:description, og:url, and twitter:card values; relative og:image or twitter:image URLs; SVG image URLs as a low-severity portability risk; and absent or non-1200x630 Open Graph dimensions as an informational review prompt.
Is 1200 by 630 required by every social platform?
No. It is a common cross-platform preset used by this scanner. LinkedIn currently recommends a 1.91:1 image and lists 1200 by 627 pixels as the minimum for its sharing module. Treat the scanner's dimension result as an informational prompt, not universal platform compliance.
Does an SVG finding mean every platform rejects SVG previews?
No. The scanner reports an SVG URL at low severity because support varies and common platform guidance emphasizes raster formats. Verify the target platform and use a raster fallback when portability matters.
Does it fetch the live page or refresh a cached preview?
No. It performs a local static-markup check. It does not call the network, follow redirects, render JavaScript, test crawler access, inspect image dimensions from the file, or refresh a platform cache.
Can a clean report guarantee the preview will work?
No. A clean report covers only the supplied markup and configured rules. Live fetchability, redirects, cache state, image bytes, platform-specific parsing, and dynamically rendered tags remain outside the scan.
Find the static markup problem before chasing the cache.
Current price and purchase option are shown on Agensi. The package stays local and read-only and works with agents that read SKILL.md.
Get the Open Graph Social Card Auditor on Agensi