Download
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.
Features
- CLI for automated webpage screenshots using a headless browser backend
- Simple default command to capture a URL into a PNG file with sensible naming
- Options for viewport size, full-page capture, clipping regions and device emulation
- Ability to execute custom JavaScript before capturing to open menus or adjust page state
- First-class support for GitHub Actions and other CI environments via a starter template
- Comprehensive docs, examples and Apache-2.0 licensed code for easy integration
Project Samples
