Open Graph Checker (Free)

Find out why your link preview is broken, including on localhost and in your build folder, in one command.

Open Graph Checker (Free) cover

What it does

See why a link preview looks wrong on Facebook, LinkedIn, Slack, Discord or X before you share it: missing or duplicate Open Graph tags, broken or wrong-size images, invalid X card types and og:url/canonical mismatches, for one page, a list of URLs or a whole build folder.

python3 -m ogcheck https://example.com/ https://example.com/blog/post
python3 -m ogcheck --dir dist --base https://example.com/          # before you deploy
python3 -m ogcheck --dir dist --base https://example.com/ --json   # for CI (exit 1 on high-severity problems)

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 4 tests OK on Python 3.13 and 3.10.

Real terminal output from Open Graph Checker: demo and passing tests

What it checks

  • Open Graph (ogp.me): the four required tags (og:title, og:type, og:image, og:url), og:description, og:image:alt (ogp.me: a page with og:image should have one), duplicates, name= instead of property=, absolute URLs, og:url vs canonical, long titles and descriptions.
  • X / Twitter cards: valid twitter:card (summary, summary_large_image, app, player) and X's documented image limits: about 2:1 for large cards, at least 300x157 (144x144 for summary), at most 4096x4096, under 5 MB, JPG/PNG/WebP/GIF, no SVG.
  • The image itself: downloaded (or read from your build folder) to confirm it loads, its real format and size, and that og:image:width/height match.
  • Across pages: one image reused on most pages, and duplicate titles.

Run ./demo.sh for the example site (5 pages, one per common mistake) and ./run_tests.sh for the tests. Python 3.9+, no dependencies. Live checks block private and local addresses; set OGCHECK_ALLOW_PRIVATE=1 for a local dev server.

Honest limits

Platforms cache previews: after fixing tags, refresh them with each platform's own debugger or post inspector. It reads the HTML your server returns and doesn't run JavaScript, which is also how most preview crawlers work.

Format and license

Zip, 14 KB, v1.0, 20 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with or endorsed by Meta, X or Google.

FAQ

Is it free?
Yes, free to use, change and share.
Can it check pages before they're live?
Yes, point --dir at your build folder and --base at the public URL.
Why does Facebook still show the old preview?
Platforms cache previews; refresh them in each platform's debugger after fixing.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Open Graph Checker (Free)

Free Open Graph checker: missing og: tags, broken or wrong-size preview images, X card errors and canonical mismatches, for live URLs or a local build.

Pairs well with

Download$19

Meta Catalog Feed Checker Skill

Check a Facebook/Instagram catalog feed against Meta's field reference: upload blockers, duplicate ids, prices, images, variants, with a fixed copy. $19.

View Meta Catalog Feed Checker Skill
Download$49

SEO Analytics Tools Bundle

Four SEO tools for your own data: Googlebot log analysis, keyword cannibalization, content decay and an SEO audit MCP server. $49 once ($96 separately).

View SEO Analytics Tools Bundle
Download$49

Product Feed Checker Bundle

Check Shopify and WooCommerce product CSVs, Google Merchant Center and Meta catalog feeds before upload, with safe fixes. $49 once ($76 separately).

View Product Feed Checker Bundle

Related