# propublica/upton

A batteries-included framework for easy web-scraping. Just add CSS! (Or do more.)

Repository: https://github.com/propublica/upton
Canonical: https://ross.abutalabs.com/products/upton
Language: HTML
License: MIT
License Family: permissive
Last push: 2018-12-26T02:48:38+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4844, "days_push": 2807, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1597, forks 108 (observed 2026-08-28T04:05:09.280420+00:00)

## What it is
Upton is a Ruby framework that handles the repetitive parts of writing web scrapers, letting developers focus on site-specific CSS selectors or XPath expressions. It includes a debug stash mode that caches responses to avoid hammering target servers, plus built-in pagination and CSV export.

## Use cases
- scrape a list of links from a website into a CSV
- extract structured data from paginated search result pages
- scrape tables or lists from news articles
- build a scraper that caches pages during development
- scrape a site politely with delays between requests
- scrape data from an API by overriding index fetching

## When to choose
- you're writing a Ruby scraper and want pagination, throttling, and caching handled for you
- you need to scrape index pages that link to instance pages
- you want a quick CSV output from a scraping project

## When to avoid
- you need a JavaScript-rendered (SPA) scraping solution
- you're not working in Ruby
- you need a maintained project - the last release was in 2018

## Facets
- artifact type: framework
- maturity: maintenance
- function: web-scraping, parser
- domain: crawlers
- platform: ruby
- tags: scraping-framework, nokogiri, csv-export, rate-limiting, debug-stash, data-engineering, automation

## Member repositories
- propublica/upton (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:09.280420+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-30T03:54:00.662544+00:00, confidence not recorded.
  - readme: https://github.com/propublica/upton (fetched 2026-08-28T04:05:09.280420+00:00, sha 946347607d6f)
- Data as of 2026-08-30T08:39:29.467469+00:00.