Black SEO Analyzer
A powerful tool for comprehensive SEO analysis, designed for SEO professionals and developers who want to ensure their websites are optimized for both search engines and AI systems.
When run without a license you're limited in the number of pages you can crawl, but no other functionality is restricted. To purchase a license and unlock unlimited analysis power, visit Black SEO Analyzer product page.
Overview
Black SEO Analyzer is a powerful tool that keeps your website visible in both traditional search results and AI-generated responses. Good technical SEO isn't just about Google rankings—it's about making sure AI systems can find and understand your content when people ask about you.
When your site's structure and metadata are optimized correctly, you'll appear in both search results and AI conversations. Black SEO Analyzer cuts through the noise and tells you exactly what's holding your site back - without corporate buzzwords, just actionable data so you don't get left behind when someone asks an AI about exactly what you sell.
True Ownership, Not Subscription
Unlike subscription-based tools that stop working when you stop paying, Black SEO Analyzer offers genuine software ownership. Your purchase includes a legally-binding source code access guarantee if we ever discontinue the product — protecting your investment permanently.
Black SEO Analyzer License: One-Time Purchase
- Lifetime software ownership
- All future updates
- Command-line efficiency
- Source code escrow guarantee
- Unlimited URLs and sites
- All advanced features included
Installation
Please read the INSTALL.md file for installation instructions.
Windows Usage
A comprehensive SEO analysis tool
Usage: black-seo-analyzer.exe [OPTIONS]
Options:
--url-to-begin-crawl <URL_TO_BEGIN_CRAWL>
URL of the sitemap to analyze
--log-file <LOG_FILE>
Path to log file
--output-type <OUTPUT_TYPE>
Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files]
--concurrent-requests <CONCURRENT_REQUESTS>
Optional Number of concurrent requests to make [default: 20]
--rate-limit <RATE_LIMIT>
Optional Rate limit in milliseconds [default: 50]
--output-file <OUTPUT_FILE>
Optional argument to specify the output file
--spa
Optional flag to indicate if the site is a Single-Page Application (SPA)
--is-sitemap
Optional flag to indicate if the initial page is a sitemap.xml
--disable-external-links
Optional flag to disable external link checking
--locale <LOCALE>
Optional locale for internationalization [default: en]
--use-anthropic-analyzer
Optional flag to enable Anthropic Claude API for SEO analysis
--anthropic-api-key <ANTHROPIC_API_KEY>
Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable)
--anthropic-model <ANTHROPIC_MODEL>
Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307]
--anthropic-prompt-file <ANTHROPIC_PROMPT_FILE>
Optional path to a file containing a custom Anthropic prompt
--use-deepseek-analyzer
Optional flag to enable DeepSeek API for SEO analysis
--deepseek-api-key <DEEPSEEK_API_KEY>
Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable)
--deepseek-model <DEEPSEEK_MODEL>
Optional DeepSeek model to use for analysis [default: deepseek-chat]
--deepseek-prompt-file <DEEPSEEK_PROMPT_FILE>
Optional path to a file containing a custom DeepSeek prompt
--use-openai-analyzer
Optional flag to enable OpenAI API for SEO analysis
--openai-api-key <OPENAI_API_KEY>
Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable)
--openai-model <OPENAI_MODEL>
Optional OpenAI model to use for analysis [default: gpt-4o]
--openai-prompt-file <OPENAI_PROMPT_FILE>
Optional path to a file containing a custom OpenAI prompt
--use-gemini-analyzer
Optional flag to enable Google Gemini API for SEO analysis
--gemini-api-key <GEMINI_API_KEY>
Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable)
--gemini-model <GEMINI_MODEL>
Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest]
--gemini-prompt-file <GEMINI_PROMPT_FILE>
Optional path to a file containing a custom Google Gemini prompt
--user-agent <USER_AGENT>
Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v25.6.61905"]
--max-pages <MAX_PAGES>
Optional maximum number of pages to crawl
--html-templates-dir <HTML_TEMPLATES_DIR>
Directory holding replacements for the built-in HTML report templates
-h, --help
Print help
-V, --version
Print version
Windows Example Usage
Basic JSON output for one site
black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type json --output-file example-report.json
Website with a sitemap
black-seo-analyzer.exe --url-to-begin-crawl https://example.com/sitemap.xml --is-sitemap --output-type json --output-file sitemap-report.json
Single page app
black-seo-analyzer.exe --url-to-begin-crawl https://spa-example.com --spa --output-type json --output-file spa-report.json
HTML folder output
black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type html-folder --output-file ./seo-reports
Linux/MacOS Usage
A comprehensive SEO analysis tool
Usage: black-seo-analyzer [OPTIONS]
Options:
--url-to-begin-crawl <URL_TO_BEGIN_CRAWL>
URL of the sitemap to analyze
--log-file <LOG_FILE>
Path to log file
--output-type <OUTPUT_TYPE>
Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files]
--concurrent-requests <CONCURRENT_REQUESTS>
Optional Number of concurrent requests to make [default: 20]
--rate-limit <RATE_LIMIT>
Optional Rate limit in milliseconds [default: 50]
--output-file <OUTPUT_FILE>
Optional argument to specify the output file
--spa
Optional flag to indicate if the site is a Single-Page Application (SPA)
--is-sitemap
Optional flag to indicate if the initial page is a sitemap.xml
--disable-external-links
Optional flag to disable external link checking
--locale <LOCALE>
Optional locale for internationalization [default: en]
--use-anthropic-analyzer
Optional flag to enable Anthropic Claude API for SEO analysis
--anthropic-api-key <ANTHROPIC_API_KEY>
Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable)
--anthropic-model <ANTHROPIC_MODEL>
Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307]
--anthropic-prompt-file <ANTHROPIC_PROMPT_FILE>
Optional path to a file containing a custom Anthropic prompt
--use-deepseek-analyzer
Optional flag to enable DeepSeek API for SEO analysis
--deepseek-api-key <DEEPSEEK_API_KEY>
Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable)
--deepseek-model <DEEPSEEK_MODEL>
Optional DeepSeek model to use for analysis [default: deepseek-chat]
--deepseek-prompt-file <DEEPSEEK_PROMPT_FILE>
Optional path to a file containing a custom DeepSeek prompt
--use-openai-analyzer
Optional flag to enable OpenAI API for SEO analysis
--openai-api-key <OPENAI_API_KEY>
Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable)
--openai-model <OPENAI_MODEL>
Optional OpenAI model to use for analysis [default: gpt-4o]
--openai-prompt-file <OPENAI_PROMPT_FILE>
Optional path to a file containing a custom OpenAI prompt
--use-gemini-analyzer
Optional flag to enable Google Gemini API for SEO analysis
--gemini-api-key <GEMINI_API_KEY>
Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable)
--gemini-model <GEMINI_MODEL>
Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest]
--gemini-prompt-file <GEMINI_PROMPT_FILE>
Optional path to a file containing a custom Google Gemini prompt
--user-agent <USER_AGENT>
Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v2025.1.100001"]
--max-pages <MAX_PAGES>
Optional maximum number of pages to crawl
--html-templates-dir <HTML_TEMPLATES_DIR>
Directory holding replacements for the built-in HTML report templates
-h, --help
Print help
-V, --version
Print version
Linux/MacOS Example Usage
Notes:
- If the binary is not executable, you may need to run
chmod +x ./black-seo-analyzerfirst. - The examples below assume the binary is in the current directory. If it's in a different directory, you'll need to provide the full path to the binary or if it is in your PATH, you can just run
black-seo-analyzer.
Basic JSON output for one site
./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type json --output-file example-report.json
Website with a sitemap
./black-seo-analyzer.exe --url-to-begin-crawl https://example.com/sitemap.xml --is-sitemap --output-type json --output-file sitemap-report.json
Single page app
./black-seo-analyzer.exe --url-to-begin-crawl https://spa-example.com --spa --output-type json --output-file spa-report.json
HTML folder output
./black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type html-folder --output-file ./seo-reports
Comprehensive Feature List
Core Functionality
- Command-line interface
- GUI interface
- Crawl websites starting from a specified URL
- Crawl websites using a sitemap
- Support for both static websites (HTTP requests) and Single Page Applications (SPAs) via headless browser
- Configurable concurrent request limit
- Configurable maximum page limit
- Detailed logging system
- Configurable log file location
Crawling Capabilities
- HTTP request-based crawler
- Headless browser-based crawler
- Automatic detection and extraction of links, scripts, stylesheets, images
- Sitemap parsing and processing
- Asynchronous processing for crawling and analysis
- Content hash generation (SHA1) for duplicate content detection
- Configurable crawl delay
- Respect robots.txt
- User-agent customization
- Domain extraction utility
SEO Analysis Modules
- Content Analysis
- Word count
- Keyword density analysis
- Readability analysis (Flesch-Kincaid score, syllable counting)
- Duplicate content detection
- Heading structure analysis (H1, H2, etc.)
- Extraction of content from additional tags (
<strong>,<em>, etc.)
- Metadata Analysis
- Title tag extraction and validation
- Meta description extraction and validation
- Meta keywords extraction
- Viewport meta tag validation
- Robots meta tag validation
- Canonical URL validation
- OpenGraph data extraction and analysis (og:title, og:description, og:image, etc.)
- Twitter Card data extraction and analysis (twitter:card, twitter:title, etc.)
- URL Structure Analysis
- Scheme validation (HTTPS preferred)
- Path analysis (length, character usage, keyword presence)
- Query parameter analysis (identification, potential issues)
- Fragment identifier analysis
- URL length validation
- Detection of common URL patterns (e.g., file extensions)
- Link Analysis
- Identification of internal and external links
- Anchor text analysis (length, descriptiveness)
- Async checks for link status (broken links)
- Async checks for redirects
- Async checks for large file sizes linked
- Analysis of link attributes (nofollow, target)
- Normalization and classification of URLs (internal/external)
- Image Analysis
- Alt tag presence and content analysis
- Image dimension analysis
- File size considerations
- Mobile-Friendliness Assessment
- Viewport meta tag analysis
- Touch target size and spacing analysis
- Responsive image analysis (
srcset,sizesattributes) - Font size analysis (readability on mobile)
- Media query analysis (breakpoint coverage)
- Performance Analysis
- Analysis of resource loading (scripts, stylesheets, images, fonts)
- Script loading analysis (
async,defer) - Stylesheet loading analysis
- Image loading analysis ()
Output Formats
- JSON output format
- JSONL (JSON Lines) output format
- XML output format
- CSV output format
- HTML report format
- Individual JSON files per page
- HTML folder output with index and individual page reports
Reporting Features
- Detailed warnings and recommendations generated by individual analyzers
- Collection of page-level metadata
- Collection of page content details (headings, etc.)
- Collection of page resources (links, scripts, styles, images)
- Collection of Web Vitals analysis results
- Performance metrics reporting (TTFB, Load Time)
- Template-based HTML report generation
Internationalization
- Multi-language support for UI text and report labels
- Built-in translations (English, Spanish, Chinese)
- Extensible translation system
- Locale used for specific recommendations
Licensing System
- Trial mode with limited functionality
- Licensed mode with full functionality
- License validation system
- Different license tiers affecting functionality
Technical Details
- Built in Rust and C++
- Asynchronous architecture
- HTML parsing and DOM manipulation
- Headless Chrome integration
- HTTP client
- Serialization/Deserialization
- Custom URL serialization wrapper
- Utility for creating safe filenames from URLs
- Command-line argument parsing
- Templating engine for HTML report generation
Frequently Asked Questions
What makes Black SEO Analyzer different from other SEO tools?
Unlike traditional SEO tools with browser-based interfaces and subscription models, Black SEO Analyzer is a tool that integrates directly into your development workflow. This approach enables automation capabilities that aren't possible with other tools, plus you genuinely own the software with a one-time purchase.
How does the source code guarantee work?
Your purchase includes a legally-binding commitment that gives you access to the full source code if we ever discontinue the product, cease operations, or fail to provide updates for 12+ consecutive months. This ensures you can continue using the software indefinitely, regardless of our company's future.
Can Black SEO Analyzer crawl JavaScript-heavy sites?
Yes, our integrated headless browser technology provides full JavaScript rendering capabilities. This ensures accurate analysis of modern web applications built with React, Angular, Vue.js, and other JavaScript frameworks.
How are updates handled?
Updates are provided via our GitHub repository and can be downloaded at any time. You'll receive all future updates at no additional cost. Life-time ownership.