seowebchecker-seoaudit-sdk

A lightweight, zero-dependency Node.js client SDK and CLI tool for instant website SEO audits, on-page analysis, and technical diagnostics.

Developed and maintained by SEOWebChecker.com — the premier free online SEO audit suite.

⚡ Highlights

• Zero External Dependencies: Fast, lightweight, pure Node.js implementation.
• 50+ SEO Checks: Meta tags, Title, Description, Canonical, Headings hierarchy (H1-H6), Image alt tags, OpenGraph, Twitter Cards, Schema JSON-LD, HTTPS, and response latency.
• CI/CD Quality Gate: Enforce --min-score 85 in GitHub Actions or GitLab CI to fail builds on SEO regressions.
• Dual Mode: Standalone local audits or connect to SEOWebChecker Cloud API.
• TypeScript Support: Ships with full .d.ts definitions.

📦 Installation

# Global CLI installation
npm install -g seowebchecker-seoaudit-sdk

# Or install in your project
npm install seowebchecker-seoaudit-sdk

🚀 Quick Start

1. Programmatic Usage (Node.js / TypeScript)

const { SEOAuditor } = require('seowebchecker-seoaudit-sdk');

const auditor = new SEOAuditor();

// Audit any URL
async function runAudit() {
  const result = await auditor.audit('https://example.com');

  console.log(`SEO Score: ${result.score.overall}/100 (Grade: ${result.score.grade})`);
  console.log(`Passed: ${result.stats.passed}, Warnings: ${result.stats.warnings}, Errors: ${result.stats.errors}`);

  for (const err of result.errors) {
    console.error(`[ERROR] ${err.title}: ${err.recommendation}`);
  }
}

runAudit();

2. Audit Raw HTML (e.g. Next.js, Nuxt, Astro SSR, Static Site Generators)

const { SEOAuditor } = require('seowebchecker-seoaudit-sdk');

const auditor = new SEOAuditor();
const result = auditor.auditHtml(renderedHtmlString, 'https://seowebchecker.com/');
console.log('Score:', result.score.overall);

🖥️ Command-Line Interface (CLI)

Run immediately via npx without installing:

# Terminal output with ANSI colors
npx seowebchecker-seoaudit-sdk https://example.com

# Save to Markdown report
npx seowebchecker-seoaudit-sdk https://example.com --format markdown --output audit.md

# Save as JSON
npx seowebchecker-seoaudit-sdk https://example.com --format json --output audit.json

# CI/CD Quality Gate (Exits with code 1 if score < 85)
npx seowebchecker-seoaudit-sdk https://example.com --min-score 85

🌐 Official Platform

Explore the full web audit suite at SEOWebChecker.com:

• Website SEO Audit Tool
• Broken Link Checker
• Schema Markup Validator

📄 License

MIT License © 2026 SEOWebChecker.