explaingit

cheeriojs/cheerio

📈 Trending★ 30,333TypeScriptAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Server-side HTML parser with jQuery-like syntax for extracting and modifying web page data without a browser.

Mindmap

mindmap
  root((repo))
    What it does
      Parse HTML or XML
      Select elements with CSS
      Extract or modify content
    Use cases
      Web scraping
      Build pipeline transforms
      Email data parsing
    Tech stack
      TypeScript
      parse5 or htmlparser2
    Key features
      jQuery-like API
      Server-side only
      Fast and lightweight
    Audience
      Backend developers
      Data engineers

Things people build with this

USE CASE 1

Scrape product prices, headlines, or other data from websites by fetching HTML and selecting elements with CSS queries.

USE CASE 2

Transform HTML markup in build pipelines or static site generators by parsing and modifying document structure.

USE CASE 3

Extract structured data from HTML emails or documents for processing in backend applications.

Tech stack

TypeScriptparse5htmlparser2

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Cheerio is a TypeScript library that lets you read and modify HTML or XML documents using a style that will feel familiar to anyone who has worked with jQuery, a once-ubiquitous JavaScript tool for selecting and changing elements on web pages. The key difference is that Cheerio runs on a server, not inside a browser, so it works with raw HTML strings rather than a live browser page. The practical use case is web scraping: you fetch the raw HTML of a web page, hand it to Cheerio, and then use CSS-style selectors to pinpoint the data you care about, a product price, a headline, a table row, and extract or modify it. You load the HTML, write something like "$('h2.title').text()" to find all h2 elements with a certain class and read their text, and get your result back instantly. Cheerio is built for speed and simplicity. It parses HTML using proven parsers (parse5 or htmlparser2), strips out the complex browser machinery that jQuery normally relies on, and gives you just the selection and manipulation API. It works in both server and browser environments. Developers reach for it when they need to process HTML programmatically, whether scraping a site, transforming markup in a build pipeline, or parsing structured data out of an HTML email.

Copy-paste prompts

Prompt 1
Show me how to use Cheerio to scrape all product names and prices from an HTML table.
Prompt 2
How do I load an HTML string into Cheerio and select elements using CSS selectors like jQuery?
Prompt 3
Write a Cheerio script that finds all links on a page and extracts their href attributes and text.
Prompt 4
How can I modify HTML content with Cheerio, like changing class names or adding attributes to elements?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.