# simonw/shot-scraper

A CLI utility for taking screenshots of websites, recording video demos and scraping sites using JavaScript

Repository: https://github.com/simonw/shot-scraper
Canonical: https://ross.abutalabs.com/products/shot-scraper
Homepage: https://shot-scraper.datasette.io
Language: Python
License: Apache-2.0
License Family: permissive
Topics: playwright, playwright-python, scraping, screenshot-utility, screenshots
Last push: 2026-07-12T23:46:52+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 80, longevity 100
- inputs: {"age_days": 1639, "days_push": 52, "days_rel": 52, "gap_med": 34, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2553, forks 129 (observed 2026-08-28T04:07:00.595007+00:00)

## What it is
shot-scraper is a Python CLI utility built on Playwright for taking automated screenshots of websites, recording video demos, and scraping pages by executing JavaScript. It can run locally or via GitHub Actions to keep screenshots up to date.

## Use cases
- take screenshots of web pages from the command line
- automate screenshots for documentation
- record video demos of websites
- scrape website content by running JavaScript in a browser
- capture full-page or element-specific screenshots
- schedule recurring webpage screenshots with GitHub Actions

## When to choose
- you need repeatable, scriptable website screenshots for docs or monitoring
- you want to scrape JavaScript-heavy sites without writing Playwright code
- you want screenshots generated automatically in CI via GitHub Actions

## When to avoid
- you need a GUI screenshot tool or browser extension
- you only need simple HTTP fetching without browser rendering
- you need large-scale distributed scraping infrastructure

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, web-scraping, image-processing, developer-tools
- domain: web-development, developer-tools, crawlers
- platform: cli, python, cross-platform
- tags: playwright, screenshots, browser-automation, video-recording, documentation, automation

## Member repositories
- simonw/shot-scraper (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:00.595007+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:23:47.488048+00:00, confidence not recorded.
  - readme: https://github.com/simonw/shot-scraper (fetched 2026-08-28T04:07:00.595007+00:00, sha 70c61f9b0a0b)
  - registry_pypi: https://pypi.org/pypi/shot-scraper/json (fetched 2026-08-29T10:07:00.729452+00:00, sha 554124ad2abd)
- Data as of 2026-08-30T08:39:29.467469+00:00.