Summary

This project offers a comprehensive SEO audit tool, available as both a command-line interface (CLI) and an Electron desktop application. It analyzes websites against 251 rules across 20 categories, including Core Web Vitals, security headers, and structured data, providing detailed insights for SEO professionals and developers.

How It Works

The tool employs a CLI or desktop app, leveraging Playwright for Core Web Vitals measurement and JavaScript rendering analysis. It supports single-page audits or multi-page crawls, storing data persistently in SQLite. The CLI offers flexible output formats, including JSON for CI/CD integration and LLM-optimized XML for AI analysis.

Quick Start & Requirements

• Installation: npm install -g @seomator/seo-audit (recommended).
• Prerequisites: Node.js 18+ (with native fetch), Playwright (install browsers via npx playwright install chromium). System Chrome, Chromium, or Edge is used for CWV measurement if installed. For the desktop app, npm install followed by npx electron-rebuild -f -w better-sqlite3 is required for native modules.
• Links: CLI quick start examples are detailed within the README.

Highlighted Details

• Features 251 audit rules across 20 categories, covering Core Web Vitals, JavaScript Rendering, Security, and Accessibility.
• Supports multiple output formats: Console, JSON, HTML, Markdown, and LLM-optimized XML.
• Includes CI/CD integration examples for GitHub Actions and GitLab CI, utilizing JSON output and exit codes.
• Persistent crawl data storage via SQLite enables historical analysis and reporting.
• The desktop app provides a visual dashboard with real-time progress, interactive results, and score history.

Maintenance & Community

No specific details regarding contributors, sponsorships, or community channels (e.g., Discord/Slack) are provided in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The permissive MIT license generally supports commercial use and integration into closed-source projects.

Limitations & Caveats

Core Web Vitals and JavaScript rendering analysis necessitate Playwright and its browser installations. The desktop app requires an additional electron-rebuild step for native module compilation. No explicit mention of specific OS support beyond standard Node.js/Playwright compatibility.