seoscan

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.com

Requirements: 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 crawl command uses standard delays and user-agents to avoid overloading servers.

License

MIT