aeo-linter

Command-Line Interface for Technical SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO), built on the Google Lighthouse architecture.

[!NOTE] 🧩 Chrome Extension Status: The companion Chrome DevTools Extension is currently In Review on the Chrome Web Store.

Official CLI for aeo-audit-linter.

⚡ Quickstart (No installation required)

# Run a quick audit in terminal
npx aeo-linter https://example.com

# Generate a visual interactive HTML dashboard (with SERP preview & gauges)
npx aeo-linter https://example.com --html -o aeo-report.html

# Output JSON report for CI/CD pipelines
npx aeo-linter https://example.com --json -o report.json

# Run specific categories only
npx aeo-linter https://example.com -c seo-fundamentals,ai-accessibility

📦 Global Installation

npm install -g aeo-linter

# Then use directly anywhere
aeo-linter https://example.com

🎛️ CLI Options

| Option | Shorthand | Description | |---|---|---| | <url> | — | The target URL to audit (required). | | --html | — | Generates an interactive visual HTML dashboard report with SERP preview. | | --json | -j | Outputs the complete report in JSON format. | | --output <file> | -o | Specifies output path for the report (.html or .json). | | --categories <list>| -c | Comma-separated list of categories to audit (seo-fundamentals, ai-accessibility, etc.). | | --fail-under <score> | — | Fails with exit code 1 if overall score is below threshold (0-100). | | --assert-category <rules...>| — | Asserts minimum scores per category (e.g. seo-fundamentals=85). | | -q, --quiet | — | Suppresses progress logs for clean CI/CD output. | | --version | -V | Displays the current version. | | --help | -h | Displays help message and option details. |

📄 License

MIT © DrowLink