# metascraper-readability

> Metascraper connector using Mozilla Readability for main article content extraction.

Latest version **5.56.2** (published 2026-08-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install metascraper-readability
pnpm add metascraper-readability
yarn add metascraper-readability
bun add metascraper-readability
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 5.56.2 |
| Published | 2026-08-17 |
| First published | 2019-03-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 22 |
| Dependencies | 4 |
| Unpacked size | 5.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2738 |
| Author | microlink.io |
| Maintainers | kikobeats |
| Keywords | article, cleanup, content, extract, html, metadata, metascraper, mozilla, parser, readability |

## Links

- npm: https://www.npmjs.com/package/metascraper-readability
- Repository: https://github.com/microlinkhq/metascraper.git#master
- Homepage: https://github.com/microlinkhq/metascraper/packages/metascraper-readability
- Issues: https://github.com/microlinkhq/metascraper/issues
- npm.io page: https://npm.io/package/metascraper-readability

## Dependencies (4)

- [happy-dom](https://npm.io/package/happy-dom.md) ~20.11.0
- [async-memoize-one](https://npm.io/package/async-memoize-one.md) ~1.2.1
- [@metascraper/helpers](https://npm.io/package/@metascraper/helpers.md) 5.56.2
- [@mozilla/readability](https://npm.io/package/@mozilla/readability.md) ~0.6.0

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 5.56.2 (latest) — 2026-08-17
- 5.55.2 — 2026-08-13
- 5.55.0 — 2026-08-09
- 5.54.1 — 2026-08-07
- 5.54.0 — 2026-08-07
- 5.53.0 — 2026-07-30
- 5.52.0 — 2026-07-29
- 5.51.1 — 2026-06-19
- 5.50.6 — 2026-06-09
- 5.50.5 — 2026-06-09
- 5.50.4 — 2026-06-04
- 5.50.1 — 2026-04-14
- 5.50.0 — 2026-03-20
- 5.49.25 — 2026-03-07
- 5.49.24 — 2026-02-17
- … 253 more at https://npm.io/package/metascraper-readability/versions

## README

<div align="center">
  <br>
  <img style="width: 500px; margin:3rem 0 1.5rem;" src="https://metascraper.js.org/static/logo-banner.png" alt="metascraper">
  <br>
  <br>
  <p align="center"><strong>metascraper-readability</strong>: A Mozilla readability connector for metascraper.</p>
  <p align="center">See our <a href="https://metascraper.js.org" target='_blank' rel='noopener noreferrer'>website</a> for more information.</p>
  <br>
</div>

## Install

```bash
$ npm install metascraper-readability --save
```

## API

### metascraper-readability([options])

#### options

##### readabilityOpts

Type: `object`

Any option provided here will passed to [Readability#options](https://github.com/mozilla/readability#new-readabilitydocument-options).

```json
{
  "responseType": "json"
}
```

## License

**metascraper-readability** © [Microlink](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/metascraper/blob/master/LICENSE.md) License.<br>
Authored and maintained by [Microlink](https://microlink.io) with help from [contributors](https://github.com/microlinkhq/metascraper/contributors).

> [microlink.io](https://microlink.io) · GitHub [microlinkhq](https://github.com/microlinkhq) · X [@microlinkhq](https://x.com/microlinkhq)

---
_Source: https://npm.io/package/metascraper-readability · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._