Social Card Bulk QA

Bulk-check public pages for Open Graph, common social-preview meta-tag, and linked manifest basics.

This Actor is for teams that publish many pages and need a quick evidence report before a launch, migration, campaign, or CMS template change. It reads public static HTML and reports machine-readable issues in the meta tags that commonly control link previews in social feeds, chat apps, and content previews.

What it checks

• Input from urls, sitemapUrl, or public csvUrl
• Page fetch status for every sampled URL
• Missing Open Graph core tags: og:title, og:type, og:image, og:url
• Duplicate conflicting Open Graph and twitter:* values
• Relative, non-http, or mismatched og:url, og:image, and twitter:image
• Missing og:description
• Missing og:image:alt when og:image is present
• Invalid og:image:width / og:image:height values
• Missing or unusual twitter:card
• Missing X/Twitter title or image fallback when neither twitter:* nor Open Graph provides one
• Repeated og:title, og:image, or og:url across sampled pages
• Linked web app manifest presence, fetchability, parseable JSON, basic name/start URL/icon/theme-color fields
• apple-touch-icon link presence

Outputs

• Dataset rows: one row per finding
• REPORT.json: full structured report and evidence pack
• REPORT.html: readable report
• REPORT.md: Markdown report

Boundaries

This is an informational diagnostic tool for public pages. It does not render a real preview, reproduce any social platform debugger, refresh platform caches, promise click-through rate, promise traffic, test installability or offline behavior, or guarantee how Facebook, X, LinkedIn, Slack, Discord, browsers, or any other platform will display or handle a shared URL.

The scanner inspects static HTML and linked manifest JSON only. It does not render JavaScript and does not evaluate private, login-gated, CAPTCHA-gated, or non-public pages.

twitter:* checks are conventional static tag-shape diagnostics only. At implementation time, the current X documentation index did not expose the legacy Cards specification page, so this Actor avoids platform-guarantee language for X cards.

Billing

Pay-per-event billing is based on reachable URLs only. Unreachable pages are reported as findings, but they are not counted as checked URLs.

References

• Open Graph protocol: https://ogp.me/
• Meta sharing for webmasters: https://developers.facebook.com/documentation/sharing/webmasters
• Meta sharing best practices: https://developers.facebook.com/documentation/sharing/best-practices
• Web app manifest overview: https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest

Related tools

• Canonical/Hreflang Bulk QA - Use when social-card pages may also have canonical or hreflang conflicts.
• Security Headers Bulk QA - Use when launch QA should include both metadata and response-header basics.
• Checksmith CI - Use earlier in the pull request when manifest and public files are still local.