lukeed

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:

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)