seolint
A robust and configurable SEO linter
seolint checks the HTML of a built site, or of live URLs, for SEO problems: titles, descriptions, canonical links, headings, links, images, social tags, and more. Some checks span the whole site, such as duplicate titles, broken links, and pages missing from the sitemap.
- 79 rules, each with its own page in the rules reference.
- Configurable in
seolint.config.ts, with type-checked rule names and options. - Extensible with your own plugins and/or presets, for one page or for the whole site.
- CI-ready, with exit codes, JSON output, and inline annotations for GitHub Actions. See an example run.
#Install
$ npm install --save-dev seolint
seolint needs Node 22.8 or later, or Bun.
#Usage
Lint the output folder of your site generator:
$ seolint public --host https://example.com
FAIL public/about/index.html
✘ A "meta[name=description]" must exist description.exists
6:2 ⚠ Must not have less than 10 characters title.content.length
21:52 ⚠ Must describe the target, not "click here" link.text.vague
FAIL Reported 1 error and 2 warnings!
#Documentation
Read the docs at seolint.io:
- Install and Quickstart
- CLI and Configuration
- CI, Plugins, and API
- Rules and Presets
See example/ for a site with custom plugins.
#Credits
Originally written by @nickreese to audit Elder Guide.
#License
MIT © Nick Reese · Luke Edwards
See also
create-worktop(3), tsm(3), tschema(3), fetch-event-stream(3), resolve.exports(3), empathic(3), mrmime(3), comptime(3), @freshie/plugin.babel(3), typescript-module(3)