Video SEO audit — schema, transcripts, thumbnails

Video SEO module

/dashboard/sites/<id>/audit/video scans every <video>, <iframe>, and YouTube/Vimeo embed across audited pages.

What's checked

• VideoObject schema — complete (name/description/thumbnailUrl/uploadDate/duration) or incomplete?
• Sitemap inclusion — does the video appear in sitemap.xml or a video sitemap?
• Transcripts — pulled from YouTube via API (Agency+ pulls up to 25/audit), schema transcript property, or HTML5 <track kind="captions">
• Captions — <track> element presence on HTML5 video
• Thumbnails — validated via probe-image-size: dims must be ≥1200×675, response status 200, byte size sensible
• Embed audit — eager-load iframes (LCP killer) flagged; cookie-tracking embeds (YouTube standard vs nocookie) flagged

Per-video score (0-100)

Weighted deductions:

• no-schema (-25 critical)
• schema-incomplete (-15 high)
• no-transcript-on-long (-10 high — only for videos >2 min)
• no-captions-html5 (-15 high)
• thumbnail-missing (-10 high)
• thumbnail-undersized (-6 medium)
• eager-embed (-8 medium)
• cookie-embed (-5 low)

Tier gating