@lxgicstudios/seo-audit

v1.0.0

Published

5 days ago

SEO audit tool for websites. Check meta tags, headings, images, links, and performance. Generate actionable reports.

0High
0Medium
0Low

lxgicstudios

seo audit meta optimization lighthouse cli

seo-audit

SEO audit tool for websites. Check meta tags, headings, images, links, and more. Generate actionable reports.

Installation

npm install -g @lxgicstudios/seo-audit

Or use directly:

npx @lxgicstudios/seo-audit https://example.com

Usage

# Audit a website
seo-audit https://example.com

# Audit local HTML file
seo-audit index.html

# Audit all HTML files in directory
seo-audit ./pages/

# Export report
seo-audit https://example.com -o report.html
seo-audit https://example.com -f json -o audit.json

What It Checks

Meta Tags

Title tag (length 10-70 characters)
Meta description (length 50-160 characters)
Keywords, robots directives
Canonical URL
Mobile viewport

Social Tags

Open Graph (og:title, og:description, og:image)
Twitter Cards

Structure

H1 tag (exactly one recommended)
Heading hierarchy (no gaps)
Schema.org structured data

Images

Alt text on all images
Lazy loading attribute

Content

Word count (300+ recommended)
Character encoding
Language attribute

Report Formats

# Text (default)
seo-audit https://example.com

# JSON
seo-audit https://example.com -f json

# Markdown
seo-audit https://example.com -f md

# HTML
seo-audit https://example.com -f html -o report.html

Example Output

═══════════════════════════════════════
  SEO AUDIT REPORT
  URL: https://example.com
  Score: 🟢 85/100
═══════════════════════════════════════

❌ ISSUES (2)
───────────────────────────────────────
  ✗ [images] 3 of 12 images missing alt text
  ✗ [social] Missing Twitter Card tags

⚠️  WARNINGS (1)
───────────────────────────────────────
  ⚠ [images] Consider adding lazy loading to images

📊 SUMMARY
───────────────────────────────────────
  Title: Example Website - Home
  Description: Welcome to our example website...
  H1: Welcome to Example
  Images: 12 (9 with alt)
  Links: 15 internal, 3 external
  Word count: 487

Programmatic Usage

const { audit, formatReport } = require('@lxgicstudios/seo-audit');

const html = `<!DOCTYPE html>...`;
const results = audit(html, 'https://example.com');

console.log(results.score);
console.log(results.issues);

// Format as markdown
const report = formatReport(results, 'md');

Why seo-audit?

Fast - No browser required
Comprehensive - Checks all essential SEO factors
Multiple formats - JSON, HTML, Markdown reports
Batch processing - Audit entire directories
Actionable - Clear issues and recommendations

Built by LXGIC Studios

🔗 GitHub · Twitter