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.

Minimal input

{
  "urls": [
    "https://checksmithcats.com/",
    "https://apify.com/checksmithcats"
  ],
  "sampleLimit": 10
}

API and scheduled use

Run the same validated input from Apify Console, the Actor API, CLI, schedules, or integrations. The run writes machine-readable findings to the default dataset and the complete report to the run storage.

Common input errors

Start with the published example and keep urls, sampleLimit in the documented JSON shape. Malformed JSON, unsupported URL schemes, missing required values, and inputs above the stated limits are rejected rather than repaired silently.