OGP and share card preview check

What it does

Checks whether pages show the right image and title when shared on social networks and chat apps.

• Extracts title, meta description, canonical, og:* and twitter:* tags with line numbers
• Renders an HTML report previewing a large-image card (Facebook / LinkedIn style) and the X card (summary_large_image or summary)
• Flags missing og:title or og:image, relative image URLs, invalid twitter:card values, duplicate tags and og:url that differs from canonical
• Measures the share image format, pixel size and file size, and flags small images, wrong width/height tags and unsupported formats such as SVG
• Length hints that count full-width CJK characters as double width

Accepts URLs, HTML files, built folders, or a text file listing URLs.

How to use

python scripts/og_check.py https://www.example.com/ --check-images --out og-report.html
python scripts/og_check.py dist --root dist --site-url https://www.example.com --out og-report.html

The agent reviews the report and proposes exact HTML fixes in the right template or setting.

Requirements

• Python 3 (standard library only)
• Network access when checking URLs

Caveats

• Previews are approximations and may differ from what each platform actually shows.
• Platforms cache previews; after fixing, refresh them with each platform's debugging tool.
• Length limits are heuristics.