Introducing seo-audit: A CLI Tool for Website SEO Audits
A fast, lightweight CLI tool that crawls your sitemap and audits each page for common SEO issues — including titles, descriptions, headers, canonical links, and broken links.
🔗 View on GitHub |
npm install -g github:cmincarelli/seo-audit
Overview
I'm excited to announce seo-audit, a new open-source command-line tool designed to help website owners and developers quickly identify and fix common SEO problems. Whether you're managing a small business site or a larger digital property, maintaining good SEO hygiene is critical for search visibility—and seo-audit makes it easy.
Key Points
What seo-audit Checks:
- Missing or improperly sized
<title>tags (should be 30–60 characters) - Missing or improperly sized meta descriptions (should be 120–160 characters)
- Missing, multiple, or empty
<h1>tags - Missing canonical link tags
- Broken outbound links (4xx/5xx errors)
Why It Matters:
- Search engines rely on these signals to understand and rank your content
- A single audit run crawls your entire sitemap, so you see the full picture
- Fixing these issues often results in immediate indexing improvements and better click-through rates from search results
How It Works:
- Fetches your sitemap (including nested sitemap indices)
- Crawls each page and parses HTML for SEO signals
- Deduplicates and checks all outbound links
- Generates a detailed report in markdown or JSON format
