headless-youtube

Read YouTube Shorts and videos from terminal via Chrome CDP and youtubei JSON interception. Tech videos only by default. Anti-doom-scroll: hard caps on results (max 50) and scroll iterations (max 8), force-muted/paused video element, STOP footer after every fetch. Zero API keys. Zero mutations. 3-layer read-only enforcement. Supports shorts, search, channel, trending, home, subscriptions, watch, playlist modes with language filtering and JSON output. Built on the same architecture as headless-twitter and headless-instagram. Use when asked to fetch youtube videos, scan youtube shorts, search youtube, monitor a channel, or pipe video metadata to scripts — without opening the YouTube app and getting sucked into the feed.