Black SEO Analyzer

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 of the sitemap to analyze --log-file Path to log file --output-type Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files] --concurrent-requests Optional Number of concurrent requests to make [default: 20] --rate-limit Optional Rate limit in milliseconds [default: 50] --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 Optional locale for internationalization [default: en] --use-anthropic-analyzer Optional flag to enable Anthropic Claude API for SEO analysis --anthropic-api-key Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable) --anthropic-model Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307] --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 Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable) --deepseek-model Optional DeepSeek model to use for analysis [default: deepseek-chat] --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 Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable) --openai-model Optional OpenAI model to use for analysis [default: gpt-4o] --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 Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable) --gemini-model Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest] --gemini-prompt-file Optional path to a file containing a custom Google Gemini prompt --user-agent Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v25.6.61905"] --max-pages Optional maximum number of pages to crawl --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 of the sitemap to analyze --log-file Path to log file --output-type Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files] --concurrent-requests Optional Number of concurrent requests to make [default: 20] --rate-limit Optional Rate limit in milliseconds [default: 50] --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 Optional locale for internationalization [default: en] --use-anthropic-analyzer Optional flag to enable Anthropic Claude API for SEO analysis --anthropic-api-key Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable) --anthropic-model Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307] --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 Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable) --deepseek-model Optional DeepSeek model to use for analysis [default: deepseek-chat] --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 Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable) --openai-model Optional OpenAI model to use for analysis [default: gpt-4o] --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 Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable) --gemini-model Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest] --gemini-prompt-file Optional path to a file containing a custom Google Gemini prompt --user-agent Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v2025.1.100001"] --max-pages Optional maximum number of pages to crawl --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-analyzer first.
• 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 ( , , 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