Full SEO audit from the terminal. One command, zero config.
Stop paying $200/mo for bloated SEO tools. Audit any website in seconds — meta tags, performance, security headers, broken links, structured data, content quality — and get AI-powered fix suggestions.
Installation
npm install -g seoscan
# or run directly without installing:
npx seoscan report https://yoursite.comRequirements: Node.js >=18
🚀 Flagship Features
1. The Full Report
Run a comprehensive SEO audit in one command. It scores your site (0-100) and grades it across 9 critical categories.
seoscan report https://yoursite.com
2. Monitor & Regression Detection
Track your SEO score over time. seoscan saves historical snapshots locally and alerts you if your score drops below a specific threshold.
# Take a snapshot and compare with previous seoscan monitor https://yoursite.com # View history and trend seoscan monitor https://yoursite.com --history # Export history to Excel (Pro) seoscan monitor https://yoursite.com --history --export xls
3. AI-Powered Fixes
Don't just find issues—fix them. seoscan uses AI to generate actionable, copy-paste fixes for every problem found (e.g., rewriting meta tags, generating Apache/Nginx header configs).
export OPENAI_API_KEY="sk-..." seoscan fix https://yoursite.com
4. Generative Engine Optimization (GEO)
Test if AI search engines (like Perplexity) recommend your website for specific keyword queries, and score your brand's visibility.
export PERPLEXITY_API_KEY="pplx-..." seoscan geo https://yoursite.com "best web design agency" --lang en
🛠️ Core Commands
You can run individual checks to focus on specific areas:
| Command | Description |
|---|---|
seoscan meta <url> |
Meta tags, headings, Open Graph, Twitter Cards |
seoscan performance <url> |
Page load speed, compression, render-blocking resources |
seoscan links <url> |
Internal/external links, broken links, redirects |
seoscan images <url> |
Alt text, dimensions, modern formats, lazy loading |
seoscan headers <url> |
Security headers (CSP, HSTS) + cache policy |
seoscan sitemap <url> |
Validate sitemap.xml structure and URLs |
seoscan robots <url> |
Parse robots.txt, check rules and directives |
seoscan structured <url> |
JSON-LD, Microdata, Schema.org validation |
seoscan content <url> |
Readability, keyword density, word count, thin content |
seoscan crawl <url> |
Deep crawl — broken links, orphan pages, redirect chains |
seoscan compare <u1> <u2> |
Side-by-side SEO comparison of two URLs |
📊 Exporting Data
Easily export your audit results to pipe into other tools or share with clients.
# Export to CSV (Free) seoscan report https://yoursite.com --export csv # Export to JSON seoscan report https://yoursite.com --export json > audit.json # Export to Excel (Pro) seoscan report https://yoursite.com --export xls
💎 Pro License
seoscan operates on a freemium model. The Free Tier allows standard audits, AI fixes, GEO testing, and CSV exports (capped rows).
The Pro Tier unlocks:
- 📊 Excel (XLS) exports for deep data manipulation
- 📈 Unlimited monitor history snapshots
- 🚀 Full CSV exports without row limits
(To unlock Pro, you need a Recognity CLI License Key, shared with Intelwatch).
⚙️ Configuration & API Keys
seoscan brings your own keys (BYOK) for AI and GEO features. Set these in your environment variables (~/.bashrc or ~/.zshrc):
# Required for `seoscan fix` (Choose one) export OPENAI_API_KEY="sk-..." export ANTHROPIC_API_KEY="sk-ant-..." # Required for `seoscan geo` export PERPLEXITY_API_KEY="pplx-..."
🔒 Privacy & Architecture
- No intermediary servers: The CLI talks directly to the websites and AI providers (OpenAI, Anthropic, Perplexity). We do not see your API keys or your audits.
- Local-first: Monitor history and settings are stored locally in
~/.seoscan/. - Respectful crawling: The
crawlcommand uses standard delays and user-agents to avoid overloading servers.
License
MIT