Features

🚀 superseo init

Generate robots, sitemap, and manifest files.

🩺 superseo doctor

Score your project's SEO with a weighted rule engine.

🔍 superseo analyze <url>

Audit any live website for technical SEO issues.

🛠️ superseo fix

Automatically create missing SEO files.

Installation

npm install -g superseo-cli
# or
pnpm add -g superseo-cli

Usage

superseo init               # Generate SEO files
superseo doctor             # SEO health check
superseo analyze <url>      # Audit a live site
superseo fix                # Fix missing files
superseo --version          # Show version
superseo --help             # Show help

Flags

• --debug — Enable debug output and stack traces
• --force / -f — Overwrite existing files (init/fix)

SuperSEO Report

────────────────────────────────
┌─────────────────────┐
│   SuperSEO Report   │
└─────────────────────┘
Language: TypeScript
Router:  App Router

┌───────────────┐
│   SEO Score   │
│   94 / 100    │
│   Excellent   │
└───────────────┘

✔ Metadata
✔ Robots
✔ Sitemap
✔ Manifest
⚠ Missing OG Image
⚠ Missing FAQ Schema

Recommendations
  1. Generate OG Image
  2. Add FAQ Schema
────────────────────────────────

What it checks

| Category | Rules | |----------------|---------------------------------------| | Metadata | Title, description, keywords | | Technical | Robots, sitemap, manifest, canonical | | Social | Open Graph, Twitter Card | | Schema | JSON-LD structured data | | Accessibility | Language, viewport, favicon, alt text |

Configuration

Create a superseo.config.js in your project root:

export default {
  siteName: 'My App',
  siteUrl: 'https://example.com',
  language: 'en',
  organization: 'My Company',
  twitter: '@myhandle',
  generateSchema: true,
  generateManifest: true,
};

Requirements

• Node.js >= 22
• Next.js App Router (app/ or src/app/)
• TypeScript or JavaScript

Contributing

See CONTRIBUTING.md for development setup and guidelines.

See ARCHITECTURE.md for design philosophy and extension guide.

License

MIT © Abishua Blessmic / Mind of a Maker