shot-scraper
A command-line utility for taking automated screenshots of websites
shot-scraper is a command-line utility for taking automated screenshots of web pages using a headless browser engine. After installation, a single command can capture a full-page screenshot of a URL and save it to a file, making it ideal for documentation, monitoring, and visual regression tasks. Under the hood it uses a modern browser (installed via a one-time shot-scraper install step) and exposes options for viewport size, full-page versus clipped screenshots, and device emulation. Beyond simple captures, it can run custom JavaScript before taking the shot, allowing you to open menus, scroll, or manipulate the DOM so the screenshot reflects the desired state. The project is deeply integrated with automation workflows: examples show it running in scheduled jobs, GitHub Actions, and bots that publish screenshots to social media or use them in docs. It ships with detailed documentation, a tutorial, and a template repository that lets you spin up an automated screenshot pipeline.