Web
vercel-seo-audit
Tech Stack
TypeScriptNode.jsCLISEOOpen Source
Overview
vercel-seo-audit is an open-source CLI tool I built specifically for developers deploying on Vercel who need a quick, comprehensive SEO health check. It runs a full audit covering robots.txt configuration, sitemap validity, meta tags (title, description, viewport, canonical), structured data (JSON-LD), Open Graph and Twitter Card tags, security headers (CSP, HSTS, X-Frame-Options), and performance-related hints. The tool outputs a clean, color-coded terminal report with actionable recommendations. It is published on npm and can be installed globally with a single command, making it easy to integrate into CI/CD pipelines or run as a pre-deployment check.
Challenges
- •Parsing and validating diverse HTML structures across different frameworks and SSR/SSG outputs
- •Handling edge cases like dynamically injected meta tags, client-side rendered content, and multi-page sitemap indexes
- •Designing a CLI output that is both information-dense and easy to scan at a glance
- •Ensuring the tool works reliably across different Node.js versions and OS environments
Solutions
- •Built a modular audit architecture where each check (robots, sitemap, meta, etc.) is an independent plugin that can be run in isolation or composed together
- •Used cheerio for HTML parsing with fallback strategies for client-rendered content, plus custom XML parsers for sitemap validation
- •Designed a color-coded severity system (pass/warn/fail) with grouped output sections and a final summary score
- •Comprehensive test suite with CI across Node 18/20/22 and published with strict semver versioning on npm
Results
54+ GitHub stars, published on npm, used by Vercel community