# bseoa — full text of core pages > bseoa (Black SEO Analyzer) is a technical SEO crawler and site audit tool built in Rust by Seth Black (Fiscus Technology, LLC). It runs locally on Windows, macOS and Linux with both a desktop GUI and a command-line interface, renders JavaScript/SPA pages with headless Chrome, and exports HTML, CSV, XML and JSON reports. Optional AI insights use your own Anthropic, OpenAI, Gemini or DeepSeek API key. - Free trial: 14 days, every feature, no page limit, no credit card. - Single License: $279 one-time purchase, lifetime updates. - Agency License: $1,999 one-time purchase for teams and agencies. - 16 analysis modules detecting 300+ technical SEO issue types. - Source code guarantee: buyers get the full source if the product is discontinued or goes 12+ months without updates. - Latest version: 26.10.23 (2026-10-23). --- # Features Source: https://www.blackseoanalyzer.com/en/features # Features That Go Beyond the Surface ## Professional GUI interface meets powerful command-line automation. Choose your workflow, get enterprise-grade insights. ## Professional GUI Interface Get the power of command-line analysis with the ease of visual tools. Our GUI makes professional SEO analysis accessible to everyone. ### Smart Autocomplete Commands suggested as you type. Tab to complete. Never memorize syntax again. ### Visual File Selection Native dialogs for folders and files. Point and click instead of typing paths. ### Color-Coded Output Errors in red, success in green. Instantly understand results at a glance. ### Real-Time Monitoring Watch crawls unfold live. See pages discovered and analyzed in real-time. ### Command History Arrow through previous commands. Repeat operations without retyping. ### Crawl Database Every crawl automatically saved. Access historical analyses anytime. ## Enterprise-Grade Architecture bseoa is built with Rust for blazing-fast performance and rock-solid reliability. No more waiting for slow crawls or dealing with crashes on large sites. ### Lightning-Fast Performance - Asynchronous architecture with Tokio runtime - Configurable concurrent requests (default: 20) - Smart rate limiting to respect server resources - Memory-efficient processing for massive sites ### Flexible Output Formats - JSON/JSONL for API integration - XML for enterprise systems - CSV for spreadsheet analysis - Beautiful HTML reports with custom templates ## Multi-Strategy Crawling Engine Stop missing critical issues on JavaScript-heavy sites. Our hybrid crawling approach ensures nothing slips through the cracks. ### HTTP-Based Crawler Lightning-fast HTTP crawling for static content. Perfect for traditional websites and server-rendered pages. ### Browser-Based Crawler Headless Chrome integration for SPAs. Accurately analyze React, Angular, Vue.js, and other JS frameworks. ### Sitemap Processing Automatic XML sitemap parsing and intelligent URL extraction. Start from sitemaps for comprehensive coverage. ## 16 Specialized SEO Analysis Modules Detect 300+ issue types across comprehensive analysis modules. Every issue comes with actionable recommendations. ### Content Analysis - Word count and content depth analysis - Keyword density calculations - Flesch-Kincaid readability scoring - Duplicate content detection - Heading structure (H1-H6) validation - Content-to-HTML ratio analysis ### Metadata & Structured Data - Title tag optimization analysis - Meta description validation - Open Graph & Twitter Cards - Schema.org markup validation - JSON-LD, Microdata, RDFa support - Canonical URL verification ### Technical SEO - URL structure analysis - HTTPS/SSL certificate monitoring - Redirect chain detection - XML sitemap validation - Robots.txt compliance - Internal/external link analysis ### Performance & Web Vitals - Core Web Vitals (LCP, FID, CLS) - First Contentful Paint (FCP) - Time to Interactive (TTI) - Resource loading analysis - Critical rendering path - Caching strategy validation ## Vector-Based Semantic Analysis Discover content insights that other crawlers can't provide. Our semantic analysis engine uses machine learning to understand your content at a deeper level — running entirely on your machine, with no page content ever sent to a third party. ### Content Similarity Detection Find semantically similar pages that might be cannibalizing each other's rankings. Goes beyond exact matches to identify conceptually similar content. - Configurable similarity thresholds - Cross-page similarity matrix - Duplicate content beyond exact matches ### Relevance Scoring Identify pages that drift from your site's main theme. Perfect for finding content that needs refocusing or removal. - Site-wide content centroid analysis - Thematic alignment scoring - Content clustering opportunities ### Runs 100% On-Device — No API Key, No Upload bseoa ships with a bundled sentence-transformer model (all-MiniLM-L12-v2) that generates embeddings locally through a pure-Rust ML runtime. There's nothing to download, no API key to configure, and no page content ever leaves your machine for this analysis. It's a separate system from bseoa's optional BYOK AI integration below, which you can turn on if you also want AI-generated content insights from a provider of your choice. ## AI-Powered Strategic Insights ### Multi-Provider AI Support #### Anthropic Claude Advanced reasoning and nuanced SEO analysis #### OpenAI GPT Comprehensive content optimization suggestions #### Google Gemini Multi-modal analysis and strategic insights #### DeepSeek Specialized technical SEO recommendations ### AI-Driven Features #### Custom Prompt Templates Tailor AI analysis to your specific needs and industry #### Meta Tag Generation AI-powered title and description optimization #### Content Gap Analysis Identify missing topics and content opportunities #### Competitive Analysis Strategic insights based on market positioning ## Built for Professional Workflows ### Dual Interface GUI for visual workflows. CLI for automation, CI/CD pipelines, and cron jobs. Choose based on your needs. ### Configuration Profiles Save complete crawl setups. Load instantly. Perfect for agencies managing multiple clients. ### Internationalization Multi-language support with built-in translations. Analyze international sites with hreflang validation. ## Ready to See What You've Been Missing? Stop settling for surface-level SEO data. Get the deep, actionable insights your sites deserve. [Download Free Trial](https://www.blackseoanalyzer.com/en/free-trial) [View Pricing](https://www.blackseoanalyzer.com/en/pricing) --- # Pricing Source: https://www.blackseoanalyzer.com/en/pricing # Simple, Transparent Pricing ## No subscription required. No hidden fees. Just pure software ownership. Built for technical SEO specialists, developers, and agencies who demand professional-grade analysis without the recurring costs. Pay once, own forever. ### Free Trial $0 Perfect for evaluation Kick the tires before you commit. 14 days of full features, no credit card, no account. Your trial key automatically converts to a permanent license when you buy. - 14 days, every feature unlocked - **GUI & CLI interfaces included** - All 16 analysis modules available - AI analysis support (BYOK) - All output formats - No credit card, no page limit [Download Free Trial](https://www.blackseoanalyzer.com/en/free-trial) Most Popular ### Single License $279 One-time purchase, lifetime access This is it: a one-time purchase for a lifetime license. No recurring fees, no hidden costs, just pure software ownership. - **Unlimited URLs and sites** - **GUI & CLI interfaces** - 300+ issue detection - Crawl history database - AI-powered analysis (BYOK) - Semantic analysis & vector database - All future updates included - **Source code guarantee** [Purchase License](https://www.blackseoanalyzer.com/buy/single) ### Agency License $1,999 For teams and agencies For the power users, the agencies, the teams that need to move mountains. Get multiple licenses with volume discounts. - **Volume discount pricing** - **GUI & CLI for all team members** - Configuration profiles - Custom report templates - Priority support - Source code guarantee [Purchase Licenses](https://www.blackseoanalyzer.com/buy/agency) ## Use it from ChatGPT or Claude Our hosted connector runs the crawls for your assistant. 14 days free the first time you connect. #### With a bseoa license $15/month or $120/year The hosted add-on for anyone who owns a Single or Agency License. #### Without a license $50/month or $500/year Hosted only: everything above from your assistant, no desktop app. Both include 25,000 crawled pages every rolling 30 days, up to 2,000 pages per crawl, and crawl results kept 90 days. When the trial ends, your assistant offers the right checkout link. [Connect your assistant](https://www.blackseoanalyzer.com/en/mcp#hosted) ## Professional Services Done-for-you add-ons to get more out of your license ### Custom HTML Report Template $699 We build a fully branded HTML report template for your agency — your logo, colors, and identity. Works with any paid license. Reusable on every crawl, forever. Delivered in 5–7 business days. [Learn More & Order](https://www.blackseoanalyzer.com/en/custom-html-reports) ## Built for Technical SEO Professionals ### Technical SEO Specialists SEO Managers, Analysts, and Consultants who need deep, granular data beyond surface-level GUI tools. ### SEO-Minded Developers Full-Stack Engineers and Front-End Developers who need to validate technical SEO implementations and prevent regressions. ### Data-Driven Marketers Digital Marketing Managers and Growth Strategists who need comprehensive data to inform strategy and demonstrate ROI. ## Why Choose bseoa? ### Beyond "Black Box" Tools Frustrated by mainstream SEO crawlers that don't provide deep technical details? Get unmatched depth with analysis of Core Web Vitals, security headers, accessibility, and semantic content relevance. ### Built for Modern Web Effortlessly audit Single-Page Applications (SPAs) with our headless Chrome-based crawler. Handle React, Angular, Vue.js, and other JavaScript-heavy sites with ease. ### Automate Everything Integrate directly into your workflow with a powerful CLI, multiple data-rich output formats (JSON, XML, CSV), and CI/CD compatibility. No more manual audits. ### All-in-One Powerhouse Consolidate your toolset with a single analyzer that covers everything from technical infrastructure and performance to AI-powered content optimization. ## Your Investment is Protected Forever True software ownership with our legally-binding source code guarantee ### Source Code Escrow Guarantee Your purchase isn't just a transaction; it's a legally-binding commitment. You get a source code access guarantee if we ever discontinue the product or cease operations. This means your investment is protected permanently. You own it, forever. [Learn more about our Source Code Guarantee →](https://www.blackseoanalyzer.com/en/source-code-guarantee) ## Frequently Asked Questions ### What makes bseoa different from other SEO tools? bseoa stands out as a Rust-built, enterprise-grade command-line tool. Unlike subscription-based tools, it provides true software ownership with a one-time purchase and a source code guarantee. It combines traditional SEO analysis with cutting-edge AI-powered insights and advanced semantic analysis, making it a comprehensive solution for SEO professionals and developers. ### 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. ### Is bseoa difficult to use for non-developers? Not anymore! bseoa now features a professional GUI interface with smart autocomplete, visual file selection, and color-coded output that makes it accessible to everyone. The GUI provides the same powerful analysis as the CLI but with an intuitive visual workflow. Technical users can still use the command-line interface for automation and CI/CD integration. ### Can bseoa crawl JavaScript-heavy sites? Yes, bseoa features a robust multi-strategy crawling engine that includes a browser-based crawler with Headless Chrome integration. This ensures accurate analysis of modern web applications and Single-Page Applications (SPAs) built with frameworks like React, Angular, Vue.js, and others, by fully rendering JavaScript content. ### How are updates handled? Updates are provided via our GitHub repository and automatically checked by the tool itself. When new versions are available, you'll be notified when running the program. You'll receive all future updates at no additional cost. ### What's the difference between the free trial and the paid version? The free trial unlocks every feature for 14 days — no credit card, no page limit, no account. After the trial expires the app stops running until you purchase a license; your trial key automatically converts to a permanent license on purchase, so there's nothing to re-paste. The paid version adds our source code guarantee, protecting your investment permanently. ### Can I use bseoa in automated environments? Absolutely. The command-line interface makes bseoa ideal for automation and integration into CI/CD pipelines, cron jobs, and custom scripts. Its support for multiple machine-readable output formats (JSON, XML, CSV) ensures seamless integration with other tools and automated workflows. ## Ready to Unlock Your Site's Full SEO Potential? Choose the license that fits your needs and start getting the deep, actionable insights you deserve. [Download Free Trial](https://www.blackseoanalyzer.com/en/free-trial) [Purchase Single License](https://www.blackseoanalyzer.com/buy/single) --- # FAQ Source: https://www.blackseoanalyzer.com/en/faq # Frequently Asked Questions Get answers to common questions about bseoa from technical implementation to licensing ## Technical Implementation ### Do I need to choose between GUI and CLI interfaces? No! Your license includes both interfaces. Use the GUI for visual workflows, client presentations, and interactive analysis. Use the CLI for automation, CI/CD integration, and remote servers. Many users employ both: GUI for exploration and CLI for automated monitoring. They share the same analysis engine and can even share configuration files. ### What makes the GUI interface special? The GUI features smart autocomplete that suggests commands as you type, visual file selection through native dialogs, color-coded output (errors in red, success in green), real-time monitoring to watch crawls unfold live, command history navigation with arrow keys, configuration profile save/load, and a crawl history database. It's the power of command-line analysis with the ease of visual tools. ### Can bseoa handle modern JavaScript frameworks? Absolutely. We've built a sophisticated multi-strategy crawling engine that includes headless Chrome integration specifically for JavaScript-heavy sites. Whether you're auditing React, Angular, Vue.js, or any other SPA framework, our browser-based crawler fully renders JavaScript content before analysis. The tool automatically detects when browser rendering is needed and switches strategies accordingly. ### How does the semantic analysis engine work? Semantic analysis runs entirely on your machine. bseoa ships with a bundled sentence-transformer model (all-MiniLM-L12-v2) running on a pure-Rust ML runtime, so no page content is sent to any external API for this analysis — there's no model download and no third-party call involved. It converts page content into 384-dimensional vectors, then calculates cosine similarity between pages to detect semantic duplicates (default threshold: 0.95) and measure content relevance to your site's overall theme via centroid analysis (default threshold: 0.7). This is separate from bseoa's optional BYOK AI integration (OpenAI, Anthropic, DeepSeek, or Google Gemini) for AI-generated content insights — that's the only part of the tool that calls an external API, and only if you choose to configure it. ### What output formats are supported for integration? We support seven output formats to fit any workflow: JSON for API integration, JSONL for streaming processing, XML for enterprise systems, CSV for spreadsheet analysis, CSV Flat for simplified data, HTML Folder for beautiful reports with navigation, and JSON Files for distributed processing. Each format is optimized for different use cases, from automated pipelines to stakeholder presentations. ## Features and Capabilities ### What makes this different from mainstream SEO crawlers? Unlike "black box" GUI tools, bseoa provides complete transparency and control. You get raw, unfiltered data with exact technical details about why something is flagged as an issue. Built in Rust for blazing performance, it combines traditional SEO metrics with AI-powered insights and on-device semantic analysis — the semantic engine never sends your content to a third party. Plus, with our lifetime license model, you own the software—no subscription required, no vendor lock-in. ### How deep does the technical SEO analysis go? We go deeper than any mainstream crawler. Beyond basic on-page checks, we analyze Core Web Vitals (LCP, FID, CLS, FCP, TTI, TBT), security headers, CSP policies, SSL certificates, render-blocking resources, JavaScript performance, structured data validation (JSON-LD, Microdata, RDFa), hreflang implementation, canonical chains, redirect paths, and much more. Every technical aspect that impacts SEO is covered. ### Can I customize the analysis for specific needs? Yes, extensively. You can configure crawling parameters (concurrency, rate limits, user agents), customize HTML report templates with your branding, define custom AI prompts for specialized analysis, adjust semantic analysis thresholds, select specific content areas for analysis via CSS selectors, and control output formats and data structures. The tool is designed to adapt to your specific requirements. ### How does the AI integration enhance SEO analysis? Our AI integration supports multiple providers (Anthropic Claude, OpenAI GPT, DeepSeek, Google Gemini) with a Bring Your Own Key (BYOK) model for security. AI analysis provides content optimization suggestions, generates meta tags, identifies content gaps, performs competitive analysis, and offers strategic SEO recommendations. You can use our default prompts or create custom ones for your specific use cases. ## Licensing and Business Model ### Why a one-time purchase instead of a subscription? We believe in true software ownership. Technical professionals need tools they can rely on indefinitely, not services that disappear when you stop paying or the company pivots. Our one-time purchase model means you own the software forever, with all future updates included. This aligns with how professional tools should work—buy once, use forever. ### What exactly is the source code guarantee? Our source code guarantee is a legally-binding commitment that protects your investment. If we ever discontinue the product, cease operations, or fail to provide updates for 12+ consecutive months, you automatically gain access to the full source code. This means you can continue using, modifying, and maintaining the software indefinitely, regardless of what happens to our company. It's true software ownership. ### What's included with the $279 license? Everything. The single license includes unlimited URL and site analysis, all current and future features, AI integration capabilities (BYOK), semantic analysis engine, all output formats, custom template support, lifetime updates, and our source code guarantee. There are no feature tiers or hidden limitations—you get the complete professional tool. ### What is the "Source Code Guarantee"? Our Source Code Guarantee is a legally binding commitment that ensures your long-term access to the software. If we ever discontinue the product, cease operations, or fail to provide updates for 12 consecutive months, you automatically gain full access to the complete source code. This empowers you to continue using, modifying, and maintaining the software indefinitely, providing true ownership and peace of mind. ### How does the agency license differ? The agency license ($1,999) provides volume licensing for teams and agencies. It includes everything in the single license but allows multiple team members to use the tool. It's perfect for agencies handling multiple client accounts, in-house teams standardizing on one tool, or consultants who need to deploy across client environments. Volume discounts are available for larger teams. ## Getting Started and Support ### What are the system requirements? bseoa runs on Windows, macOS, and Linux. Built in Rust, it's incredibly efficient with minimal system requirements. For JavaScript rendering, you'll need Chrome or Chromium installed. The tool automatically detects your browser installation. For AI features, you'll need API keys from your chosen providers. That's it—no complex dependencies or runtime environments. ### How do I integrate this into my CI/CD pipeline? Integration is straightforward. The command-line interface accepts all parameters as arguments, making it perfect for automation. You can run it in your build pipeline to catch SEO regressions, schedule regular audits via cron, or trigger analysis on deployment. Output formats like JSON and XML make it easy to parse results and fail builds on critical SEO issues. We provide example scripts for popular CI/CD platforms. ### Is bseoa difficult to use for non-developers? Not anymore! The new GUI interface with smart autocomplete, visual file selection, and color-coded output makes professional SEO analysis accessible to everyone. The GUI provides the same powerful analysis as the CLI but with an intuitive visual workflow. Simply start typing and the interface suggests commands—no memorization required. For automation and CI/CD integration, technical users can still use the command-line interface. ### What's included with the $279 license? Everything. The single license includes both GUI and CLI interfaces, unlimited URL and site analysis, 300+ issue detection, crawl history database, AI integration capabilities (BYOK), semantic analysis engine, all output formats, custom template support, configuration profiles, lifetime updates, and our source code guarantee. There are no feature tiers or hidden limitations—you get the complete professional tool. ## Advanced Use Cases ### Can I use this for competitive analysis? Yes, bseoa excels at competitive analysis. You can crawl competitor sites to understand their technical implementation, content structure, and optimization strategies. The AI integration can provide insights on content gaps and opportunities. The semantic analysis engine can identify topic clusters and content strategies. Export the data to compare multiple competitors side-by-side. ### How does it handle large enterprise sites? Built in Rust with an asynchronous architecture, bseoa handles massive sites efficiently. Configure concurrent requests and rate limiting to match server capacity. The streaming output formats (JSONL) allow processing results as they're generated, preventing memory issues. For sites with millions of pages, you can segment crawls by subdomain or directory, then aggregate results programmatically. ### Can I extend functionality with custom scripts? Absolutely. The structured output formats make it easy to build custom analysis scripts. Parse JSON output to create custom metrics, integrate with your data warehouse, or build automated reporting systems. Many users create wrapper scripts for specific use cases like monitoring Core Web Vitals trends, tracking structured data implementation, or validating SEO requirements in staging environments. ### What about API rate limits with AI providers? The tool includes intelligent rate limiting and retry logic for AI API calls. You can configure request delays and concurrent API calls. For large-scale analysis, we recommend using providers with higher rate limits or running multiple instances with different API keys. The tool gracefully handles rate limit errors and continues analysis, marking pages that couldn't be AI-analyzed for later processing. ## Ready to Take Control of Your SEO Analysis? Stop renting your tools. Own your SEO analyzer with a one-time purchase and lifetime updates. [Free Trial](https://www.blackseoanalyzer.com/en/free-trial) [Purchase Full License](https://www.blackseoanalyzer.com/buy/single) ## Still Have Questions? We're here to help. Check out our documentation or reach out directly. [View Documentation](https://github.com/sethblack/black-seo-analyzer) [Contact Support](mailto:hello@blackseoanalyzer.com) --- # Getting Started Source: https://www.blackseoanalyzer.com/en/getting-started # Getting Started with bseoa bseoa offers both a user-friendly GUI and powerful CLI. Choose the interface that best fits your workflow. ## Quick Start Guide ### GUI Interface (Recommended) Perfect for visual workflows, single-site analysis, and users new to SEO tools. 1 Download & Install Get the installer for your OS from the [download page](https://www.blackseoanalyzer.com/en/download) 2 Launch Application Open "bseoa" from your Applications/Start Menu 3 Set URL & Configure Use `set url` command and configure options with autocomplete 4 Start Crawling Run `crawl` command to analyze your site ### CLI Interface (For Automation) Ideal for scripting, CI/CD pipelines, and batch processing multiple sites. 1 Download Binary Get the CLI binary for your platform from the [download page](https://www.blackseoanalyzer.com/en/download) 2 Make Executable Run `chmod +x black-seo-analyzer` (Unix/Mac) 3 Run Analysis `./black-seo-analyzer --url-to-begin-crawl https://example.com` 4 View Results Check the generated output files or pipe to processing tools ## Installation ### System Requirements - **Operating Systems:** Windows 10+, macOS 10.15+, Linux (glibc 2.17+) - **Architecture:** x86_64, ARM64 (Apple Silicon native) - **Memory:** 512MB RAM minimum, 2GB+ recommended for large sites - **Browser:** Chrome/Chromium (for JavaScript rendering) - **Storage:** 100MB for binary, additional space for reports ### Download & Install Visit the [download page](https://www.blackseoanalyzer.com/en/download) to get: - **Windows:** MSI installer for easy setup - **macOS:** DMG package (Universal Binary for Intel & Apple Silicon) - **Linux:** Standalone binaries for various distributions - **Source Code:** Build from source for advanced users ## Using the GUI ### Essential GUI Commands The GUI features smart autocomplete and visual dialogs. Press Tab to autocomplete any command. ``` # Set the URL to analyze > set url https://example.com # Set output directory > set output-dir ./reports # Configure crawl options > set concurrent-requests 10 > set rate-limit 50 # Start the analysis (output format is chosen later, at export time) > crawl # View previous crawls > list crawls # Export a previous crawl (using session ID from list crawls) > export crawl_1762367280_8991c20b html-folder # Save configuration for reuse > save my-config.json # Load saved configuration > load my-config.json ``` ### GUI Features - **Command Autocomplete:** Start typing and press Tab to see available commands - **Command History:** Use arrow keys to navigate through previous commands - **Visual File Pickers:** Native dialogs for selecting folders and files - **Configuration Management:** Save and load settings as JSON files - **Crawl History:** View and export results from previous analyses - **License Management:** Easy license activation with `license` ## Using the CLI ### Command Structure The CLI follows this pattern for automation and scripting: ``` ./black-seo-analyzer --url-to-begin-crawl [URL] [OPTIONS] # Basic examples: ./black-seo-analyzer --url-to-begin-crawl https://example.com ./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type json --output-file report.json ./black-seo-analyzer --url-to-begin-crawl https://example.com --max-pages 100 --output-type html-folder --output-file ./report ``` ### Essential CLI Options ``` # Crawl Controls --max-pages 1000 # Limit pages to crawl --concurrent-requests 10 # Parallel requests (default 20) --rate-limit 100 # Milliseconds between requests (default 50) # Output --output-type json # json | jsonl | jsonl-summary | xml | csv | # csv-flat | html-folder | json-files | # sitemap | topic-cluster | broken-links --output-file ./report # Output file or folder path # JavaScript Rendering --spa # Use the headless-browser crawler for # single-page apps (off by default) # Session / Reporting --session-id abc123 # Re-target an existing crawl session --generate-output # Regenerate output without re-crawling ``` ## GUI vs CLI: Which to Use? | Feature / Use Case | GUI | CLI | | --- | --- | --- | | **Ease of Use** | ✅ User-friendly with autocomplete and visual dialogs | ⚠️ Requires knowledge of command-line options | | **Automation** | ⚠️ Limited automation capabilities | ✅ Perfect for scripts and CI/CD pipelines | | **Batch Processing** | ⚠️ Manual configuration per site | ✅ Excellent for multiple sites | | **Configuration Management** | ✅ Save/load JSON configs with visual interface | ✅ Environment variables and command-line args | | **Crawl History** | ✅ Built-in crawl history and re-export capabilities | ⚠️ Manage output files manually | | **Learning Curve** | ✅ Low - guided by autocomplete | ⚠️ Medium - requires CLI familiarity | | **Remote Execution** | ⚠️ Requires desktop environment | ✅ Works over SSH and headless servers | **💡 Pro Tip:** Both interfaces use the same license and share the same underlying analysis engine. Use GUI for daily work and CLI for automation! ## License Activation After purchase, you'll receive a license key via email. The same license works for both GUI and CLI. #### GUI Activation: `> license YOUR_LICENSE_KEY` #### CLI Activation: `./black-seo-analyzer --store-license YOUR_LICENSE_KEY` **Free Trial:** Sign up at [blackseoanalyzer.com/free-trial](https://www.blackseoanalyzer.com/free-trial) for a 14-day full-feature trial — no credit card, no page limit. After 14 days the trial expires and the app stops running until you purchase a license. ## Next Steps ### Full Documentation Explore advanced features, AI integration, and automation options. [Read Documentation →](https://www.blackseoanalyzer.com/en/cli-documentation) ### Community Support Join discussions, share tips, and get help from the community. [Visit Forum →](https://github.com/sethblack/black-seo-analyzer/discussions) ### Video Tutorials Watch step-by-step guides and advanced technique tutorials. [Watch Videos →](https://www.youtube.com/@SethBlack) ## Ready to Get Started? Download bseoa today and start improving your website's SEO. [Download Now](https://www.blackseoanalyzer.com/en/download) [View Full Docs](https://www.blackseoanalyzer.com/en/cli-documentation) --- # CLI Documentation Source: https://www.blackseoanalyzer.com/en/cli-documentation # Documentation Complete guide for both GUI and command-line interfaces with advanced SEO analysis features ## Installation ### System Requirements - **Operating Systems:** Windows 10+, macOS 10.15+, Linux (glibc 2.17+) - **Architecture:** x86_64, ARM64 (Apple Silicon native) - **Memory:** 512MB RAM minimum, 2GB+ recommended for large sites - **Browser:** Chrome/Chromium (for JavaScript rendering) - **Storage:** 100MB for binary, additional space for reports ### GUI Installation (Recommended for Most Users) **Windows:** ``` # Download and install the EXE installer # Visit: https://www.blackseoanalyzer.com/en/download # Double-click to install # Or via PowerShell: Invoke-WebRequest -Uri https://www.blackseoanalyzer.com/en/download -OutFile BlackSEOAnalyzerSetup.exe .\BlackSEOAnalyzerSetup.exe ``` **macOS:** ``` # Download the DMG installer (Universal Binary for Intel and Apple Silicon) curl -L -o Black-SEO-Analyzer.dmg https://www.blackseoanalyzer.com/en/download # Open the DMG and drag to Applications folder open Black-SEO-Analyzer.dmg ``` **Launch GUI:** After installation, launch "bseoa" from your Applications folder (macOS) or Start Menu (Windows). ### CLI Installation (For Automation & Scripting) **Windows CLI:** ``` # Download x86-64 binary Invoke-WebRequest -Uri https://www.blackseoanalyzer.com/en/download -OutFile black-seo-analyzer.exe # Verify installation .\black-seo-analyzer.exe --version ``` **macOS CLI (Apple Silicon):** ``` # Download ARM64 binary curl -L -o black-seo-analyzer https://www.blackseoanalyzer.com/en/download # Make executable chmod +x black-seo-analyzer # Verify installation ./black-seo-analyzer --version ``` **Linux CLI:** ``` # Download x86-64 binary curl -L -o black-seo-analyzer https://www.blackseoanalyzer.com/en/download # Make executable chmod +x black-seo-analyzer # Verify installation ./black-seo-analyzer --version ``` Note: CLI binaries can be moved to your PATH for system-wide access (e.g., /usr/local/bin on Unix systems). ### License Activation After purchasing, you'll receive a license key via email. **GUI Activation:** Use the `license` command in the GUI: ``` > license YOUR_LICENSE_KEY ``` **CLI Activation:** ``` ./black-seo-analyzer --license-key YOUR_LICENSE_KEY ``` The license is stored locally in `~/.black-seo-analyzer/license.key` and works for both GUI and CLI. **Note:** A license key is required to run any crawl. Sign up for a free 14-day full-feature trial at [blackseoanalyzer.com/free-trial](https://www.blackseoanalyzer.com/free-trial) — every analyzer, no page limit, no credit card required. ## Basic Usage ### GUI Usage The GUI features smart autocomplete and visual file selection. Common commands: ``` # Set the URL to crawl > set url https://example.com # Set output directory > set output-dir ./reports # Start the crawl (output format is chosen later, at export time) > crawl # View crawl history > list crawls # Export a previous crawl (using session ID from list crawls) > export crawl_1762367280_8991c20b html-folder # Load saved configuration > load client-config.json # Save current configuration > save my-config.json ``` Tip: Start typing any command and press Tab to autocomplete. Use arrow keys to navigate command history. ### CLI Command Structure The CLI follows this pattern for automation and scripting: ``` ./black-seo-analyzer [OPTIONS] ``` **Examples:** ``` # Basic crawl with default settings ./black-seo-analyzer --url-to-begin-crawl https://example.com # Crawl with specific output format ./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type json # Generate output from existing crawl session ./black-seo-analyzer --generate-output --output-type html-folder --output-file ./reports ``` ### Essential Parameters ``` # Core Options --url-to-begin-crawl # URL of the website to analyze (required for crawling) --output-type # Output format: json, jsonl, xml, csv, csv-flat, html-folder, json-files --output-file # Output directory or file path --log-file # Path to log file # Crawling Controls --max-pages # Maximum number of pages to crawl --concurrent-requests # Number of concurrent requests [default: 20] --rate-limit # Rate limit in milliseconds [default: 50] --user-agent # User-Agent string [default: "black-seo-analyzer v26.9.14"] # Special Modes --spa # Enable Single-Page Application (SPA) rendering mode --is-sitemap # Treat the URL as a sitemap.xml file --disable-external-links # Disable external link checking --locale # Locale for internationalization [default: en] # Session Management --generate-output # Generate output from database instead of crawling --session-id # Crawl session ID to generate output from (uses latest if not specified) --db-path # Path to SQLite database file [default: crawl.db] ``` ### Common Use Cases **Full site audit with HTML report:** ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type html-folder --output-file ./audit-report ``` **Quick technical check (first 50 pages):** ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com --max-pages 50 --output-type json ``` **JavaScript SPA analysis:** ``` ./black-seo-analyzer --url-to-begin-crawl https://spa-site.com --spa ``` **Analyze a sitemap:** ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com/sitemap.xml --is-sitemap ``` **Competitive analysis with AI insights:** ``` ./black-seo-analyzer --url-to-begin-crawl https://competitor.com --use-openai-analyzer --openai-api-key $OPENAI_API_KEY ``` ## CLI vs GUI Command Syntax Quick reference comparing command-line interface (CLI) and graphical user interface (GUI) commands. Both versions provide identical functionality with different syntax. | Task | CLI Syntax | GUI Syntax | | --- | --- | --- | | Basic Crawl | `./black-seo-analyzer --url-to-begin-crawl https://example.com` | `set url https://example.com` `crawl` | | Set Output Directory | `--output-file ./reports` | `set output-dir` (opens folder browser) | | Set Output Type | `--output-type html-folder` | `export html-folder` (chosen at export time, not via set) | | Concurrent Requests | `--concurrent-requests 20` | `set concurrent-requests 20` | | Rate Limiting | `--rate-limit 100` | `set rate-limit 100` | | Max Pages | `--max-pages 100` | `set max-pages 100` | | SPA Mode | `--spa` | `set spa true` | | Sitemap Analysis | `--is-sitemap` | `set is-sitemap true` | | User Agent | `--user-agent "MyBot/1.0"` | `set user-agent MyBot/1.0` | | License Key | `--license-key YOUR_KEY` | `license YOUR_KEY` | | OpenAI Analyzer | `--use-openai-analyzer --openai-api-key KEY` | `set use-openai true` `set openai-key YOUR_KEY` | | Anthropic Claude | `--use-anthropic-analyzer --anthropic-api-key KEY` | `set use-anthropic true` `set anthropic-key YOUR_KEY` | | Save Configuration | Not available | `save config.json` | | Load Configuration | Not available | `load config.json` | | List Past Crawls | Not available | `list crawls` | | Export Crawl | `--session-id abc123 --generate-output --output-type html-folder` | `export abc123 html-folder` | | Show Config | Not available | `show config` | | View Version | `--version` | `version` | | View Help | `--help` | `help` | **Need more GUI examples?** Check out the [GUI Documentation](https://www.blackseoanalyzer.com/en/gui-documentation) for step-by-step workflows, real-world examples, and advanced features. ## Configuration ### Environment Variables Set API keys and sensitive data via environment variables: ``` # AI Provider Keys (can be used instead of command-line flags) export OPENAI_API_KEY="sk-..." export ANTHROPIC_API_KEY="sk-ant-..." export DEEPSEEK_API_KEY="..." export GEMINI_API_KEY="..." ``` ### Custom Templates The HTML reports are rendered from [Tera templates](https://github.com/sethblack/black-seo-analyzer/tree/main/html-templates) compiled into the binary. To change one, copy it into a directory of your own, edit it, and point `--html-templates-dir` at that directory: ``` my-templates/ ├── index_file.html # index.html, the crawl summary ├── page_file.html # wrapper document for each file in pages/ ├── page.html # the per-page report body ├── sitemap_graph.html # --output-type sitemap └── topic_cluster_graph.html # --output-type topic-cluster ``` Use with: ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type html-folder --html-templates-dir ./my-templates ``` The same flag works when regenerating output from an already-crawled session, so you can re-render against a changed template without crawling again: ``` ./black-seo-analyzer --generate-output --session-id abc123 --output-type html-folder --html-templates-dir ./my-templates ``` A few rules worth knowing: - Only those five filenames are recognized. Supply just the ones you want to change — anything missing falls back to the built-in copy. - A directory that does not exist, or that contains none of those filenames, is rejected with an error rather than ignored. - A template that fails to parse aborts the export and names the file it came from. - There is no asset pipeline. Inline your CSS, JavaScript and images, or reference them by absolute URL. - `sitemap_graph.html` and `topic_cluster_graph.html` are not Tera templates — they are copied verbatim except for the literal `{json_data}`, which is replaced with the graph data as JSON. The templates are Tera 2, which follows Jinja2 closely but not exactly: filter arguments are keyword arguments (`{{ score | round(precision=1) }}`), and slicing is written `{% for k in keyword_analysis[:50] %}` rather than with a `slice` filter. The full list of variables each template receives is in the [template README](https://github.com/sethblack/black-seo-analyzer/blob/main/html-templates/README.md). ## AI Integration ### Supported AI Providers | Provider | Default Model | Best For | | --- | --- | --- | | OpenAI | gpt-4o | General analysis, content optimization | | Anthropic | claude-3-haiku-20240307 | Deep technical analysis, code review | | DeepSeek | deepseek-chat | Cost-effective bulk analysis | | Google Gemini | gemini-1.5-flash-latest | Multimodal analysis with screenshots | ### AI Analysis Configuration **OpenAI Configuration:** ``` # Use OpenAI for SEO analysis ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --use-openai-analyzer \ --openai-api-key $OPENAI_API_KEY \ --openai-model gpt-4o \ --openai-prompt-file ./prompts/seo-analysis.txt ``` **Anthropic Claude Configuration:** ``` # Use Anthropic Claude for analysis ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --use-anthropic-analyzer \ --anthropic-api-key $ANTHROPIC_API_KEY \ --anthropic-model claude-3-haiku-20240307 \ --anthropic-prompt-file ./prompts/technical-review.txt ``` **DeepSeek Configuration:** ``` # Use DeepSeek for cost-effective analysis ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --use-deepseek-analyzer \ --deepseek-api-key $DEEPSEEK_API_KEY \ --deepseek-model deepseek-chat ``` **Google Gemini Configuration:** ``` # Use Google Gemini for analysis ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --use-gemini-analyzer \ --gemini-api-key $GEMINI_API_KEY \ --gemini-model gemini-1.5-flash-latest \ --gemini-prompt-file ./prompts/content-analysis.txt ``` ### Custom AI Prompts Create custom prompt files for specific analysis needs. Save your prompt as a text file: ``` # seo-analysis-prompt.txt Analyze this page content for: 1. Keyword density and semantic relevance 2. Content structure and readability 3. Missing topics based on search intent 4. Internal linking opportunities 5. Schema.org markup recommendations Provide specific, actionable recommendations for improvement. ``` Use custom prompts with any AI provider: ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --use-openai-analyzer \ --openai-prompt-file ./seo-analysis-prompt.txt ``` ## Advanced Features ### Semantic Analysis Engine Semantic analysis runs on-device (bundled all-MiniLM-L12-v2 model, no external API call) and is enabled with a single flag. It powers duplicate-content and topical-relevance detection automatically during a crawl: ``` # Enable semantic analysis during a crawl ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --enable-semantic-analysis ``` **Find pages similar to a phrase or topic:** ``` # Search a completed crawl for semantically similar pages ./black-seo-analyzer \ --enable-semantic-analysis \ --semantic-query "return policy and refunds" \ --query-limit 20 ``` Similarity thresholds (0.95 for duplicates, 0.7 for topical relevance) are fixed internally rather than configurable via CLI flags. ### Performance & Structured Data Checks Performance (Core Web Vitals, load timing) and structured-data (Schema.org) checks are built-in analyzers that run automatically as part of every crawl — there's no separate flag to turn them on. What you control is how much runs, via `--audit-profile`: ``` # Run every analyzer, including performance and structured data (default) ./black-seo-analyzer --url-to-begin-crawl https://example.com --audit-profile full # Run only Tier 1 critical technical/indexing checks ./black-seo-analyzer --url-to-begin-crawl https://example.com --audit-profile critical # Tier 1 + Tier 2: critical issues plus core on-page & duplicate content ./black-seo-analyzer --url-to-begin-crawl https://example.com --audit-profile core # Tier 1-3: everything except the most advanced checks ./black-seo-analyzer --url-to-begin-crawl https://example.com --audit-profile standard # Fast pass covering the most common issues only ./black-seo-analyzer --url-to-begin-crawl https://example.com --audit-profile quick ``` There's no CLI option to set custom Core Web Vitals thresholds or to selectively enable only compression/caching/CDN checks — those results are included whenever the Performance and Resources analyzers run under the chosen profile. ## Output Formats ### Format Comparison | Format | Use Case | Example | | --- | --- | --- | | `json` | API integration, programmatic processing | `--output-type json --output-file report.json` | | `jsonl` | Streaming, large datasets | `--output-type jsonl --output-file report.jsonl` | | `jsonl-summary` | One-line-per-issue summaries for large crawls | `--output-type jsonl-summary --output-file summary.jsonl` | | `xml` | Enterprise systems, feed ingestion | `--output-type xml --output-file report.xml` | | `csv` | Spreadsheet analysis, data science | `--output-type csv --output-file report.csv` | | `csv-flat` | Simplified metrics, dashboards | `--output-type csv-flat --output-file report-flat.csv` | | `html-folder` | Visual reports, client deliverables | `--output-type html-folder --output-file ./report` | | `json-files` | Distributed processing, archival | `--output-type json-files --output-file ./report` | | `sitemap` | Regenerating an XML sitemap from crawl results | `--output-type sitemap --output-file sitemap.xml` | | `topic-cluster` | Grouping pages by semantic similarity | `--output-type topic-cluster --output-file clusters.json` | | `broken-links` | Isolated report of 4xx/5xx links only | `--output-type broken-links --output-file broken.csv` | ### Processing Output Examples The CLI always writes its report to a file (or folder) rather than to standard output, so pipe-based workflows read the resulting file after the crawl finishes: **Extract critical issues with jq:** ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --output-type json --output-file report.json jq '.issues[] | select(.severity == "critical") | {url: .url, issue: .type}' report.json ``` **Generate a broken-links-only report directly:** ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --output-type broken-links --output-file broken-pages.csv ``` **Use the compact per-issue summary for large sites:** ``` ./black-seo-analyzer --url-to-begin-crawl https://large-site.com \ --max-pages 10000 --output-type jsonl-summary --output-file summary.jsonl ``` ## Automation & CI/CD ### GitHub Actions Integration ``` name: SEO Audit on: push: branches: [main] schedule: - cron: '0 0 * * 0' # Weekly jobs: seo-audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Download bseoa run: | curl -L https://github.com/sethblack/black-seo-analyzer/releases/latest/download/black-seo-analyzer-linux-x64.tar.gz | tar xz chmod +x black-seo-analyzer - name: Run SEO Audit env: LICENSE_KEY: ${{ secrets.BLACK_SEO_LICENSE }} OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }} run: | ./black-seo-analyzer --store-license $LICENSE_KEY ./black-seo-analyzer \ --url-to-begin-crawl https://staging.example.com \ --max-pages 100 \ --use-openai-analyzer --openai-api-key $OPENAI_API_KEY \ --output-type json --output-file audit.json - name: Check for Critical Issues run: | CRITICAL_COUNT=$(jq '[.issues[] | select(.severity == "critical")] | length' audit.json) if [ $CRITICAL_COUNT -gt 0 ]; then echo "Found $CRITICAL_COUNT critical SEO issues!" exit 1 fi - name: Upload Report uses: actions/upload-artifact@v3 with: name: seo-audit-report path: audit.json ``` ### Monitoring Script Create a monitoring script for regular checks: ``` #!/bin/bash # seo-monitor.sh SITES=( "https://example.com" "https://blog.example.com" "https://shop.example.com" ) WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL" for site in "${SITES[@]}"; do echo "Auditing $site..." OUTFILE="audit-$(date +%Y%m%d)-${site//https:\/\//}.json" ./black-seo-analyzer \ --url-to-begin-crawl "$site" \ --max-pages 50 \ --output-type json --output-file "$OUTFILE" # Check for issues CRITICAL=$(jq '[.issues[] | select(.severity == "critical")] | length' "$OUTFILE") HIGH=$(jq '[.issues[] | select(.severity == "high")] | length' "$OUTFILE") if [ $CRITICAL -gt 0 ] || [ $HIGH -gt 5 ]; then curl -X POST $WEBHOOK_URL \ -H 'Content-Type: application/json' \ -d "{\"text\":\"⚠️ SEO Alert for $site: $CRITICAL critical, $HIGH high priority issues found\"}" fi done ``` ### Docker Integration Run bseoa in a container: ``` # Dockerfile FROM debian:bullseye-slim RUN apt-get update && apt-get install -y \ curl \ jq \ chromium \ && rm -rf /var/lib/apt/lists/* WORKDIR /app RUN curl -L https://github.com/sethblack/black-seo-analyzer/releases/latest/download/black-seo-analyzer-linux-x64.tar.gz | tar xz ENV CHROME_PATH=/usr/bin/chromium ENTRYPOINT ["./black-seo-analyzer"] ``` Build and run: ``` # Build image docker build -t black-seo-analyzer . # Run analysis docker run --rm \ -v $(pwd)/reports:/app/reports \ -e LICENSE_KEY=$BLACK_SEO_LICENSE \ black-seo-analyzer \ --url-to-begin-crawl https://example.com \ --output-type html-folder --output-file /app/reports ``` ## Troubleshooting ### Common Issues **Site relies on JavaScript rendering and pages look empty in the report:** ``` # Enable the headless-browser crawler for single-page apps ./black-seo-analyzer --url-to-begin-crawl https://example.com --spa ``` Without `--spa`, pages are fetched with a plain HTTP request and no JavaScript executes — that's the right default for static/server-rendered sites, and the one to flip on for SPAs. **Getting rate-limited or blocked:** ``` # Slow down and reduce concurrency (rate-limit is milliseconds between requests) ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --rate-limit 1000 --concurrent-requests 2 ``` **Memory issues on large sites:** ``` # Cap total pages crawled and use the compact per-issue summary format ./black-seo-analyzer --url-to-begin-crawl https://large-site.com \ --max-pages 10000 --output-type jsonl-summary --output-file summary.jsonl ``` ### Logging Logging is always on (info level) and goes to standard output by default. Send it to a file instead with `--log-file`: ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com --log-file crawl.log ``` There isn't a separate verbose/debug flag or per-component debug switches today — the log level and detail are fixed. ### Performance Tuning **Optimize for speed** (skip the headless browser and raise concurrency — be respectful of the target site): ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --concurrent-requests 50 --rate-limit 20 ``` **Optimize for accuracy on JavaScript-heavy sites** (render with the headless browser, at lower concurrency): ``` ./black-seo-analyzer --url-to-begin-crawl https://example.com \ --spa --concurrent-requests 5 ``` There's no flag to selectively skip specific resource types or to force full-page screenshots on every page — those aren't configurable today. ## Ready to Master Professional SEO Analysis? Choose your interface: GUI for visual workflows or CLI for automation. Both included with every license. [Download Free Trial](https://www.blackseoanalyzer.com/en/free-trial) [Get Full License](https://www.blackseoanalyzer.com/buy/single) ## Additional Resources Expand your knowledge and connect with the community ### GitHub Repository Source code, issues, and community contributions [View on GitHub →](https://github.com/sethblack/black-seo-analyzer) ### Video Tutorials Step-by-step guides and advanced techniques [Watch Tutorials →](https://www.youtube.com/@SethBlack) ### Community Forum Get help, share tips, and discuss features [Join Discussion →](https://github.com/sethblack/black-seo-analyzer/discussions) --- # GUI Documentation Source: https://www.blackseoanalyzer.com/en/gui-documentation # GUI Documentation Step-by-step guides for using the Windows and macOS desktop applications ## Getting Started with GUI When you launch the GUI application, you'll see a dark-themed window with: - **Output area** (top): Displays results, messages, and crawl progress with color-coded output - **Input field** (bottom): Type commands here with smart autocomplete - **Submit button**: Click or press Enter to execute commands ### Key Features - **Command History**: Use Up/Down arrow keys to navigate previous commands - **Auto-completion**: Press Tab to complete commands as you type - **Native Dialogs**: File and folder pickers for easy path selection - **Real-time Feedback**: Color-coded output (errors in red, success in green, warnings in yellow) - **Configuration Management**: Save and load project-specific settings ## Example Workflows ### Example 1: Simple Website Audit Perfect for quick SEO health checks ``` > set url https://mywebsite.com URL set to: https://mywebsite.com > set output-dir [Folder browser opens - select a directory] Output directory set to: C:\Reports\MyWebsite Vector database path automatically set to: C:\Reports\MyWebsite\vector.db > set output-type html-folder Output type set to: html-folder > crawl Starting crawl of https://mywebsite.com... [Real-time progress displayed] Crawl completed: 47 pages analyzed Report saved to: C:\Reports\MyWebsite\ ``` ### Example 2: Quick Technical Check (50 Pages) Fast analysis of site's technical SEO with page limit ``` > set url https://example.com URL set to: https://example.com > set max-pages 50 Max pages set to: 50 > set concurrent-requests 10 Concurrent requests set to: 10 > set output-type json Output type set to: json > crawl Starting crawl (max 50 pages)... [Progress updates] Crawl completed: 50 pages analyzed ``` ### Example 3: Single-Page Application (SPA) Analysis Analyze JavaScript-heavy websites with proper rendering ``` > set url https://spa-app.com URL set to: https://spa-app.com > set spa true SPA mode enabled > set output-type html-folder Output type set to: html-folder > crawl Starting SPA crawl with JavaScript rendering... [Progress updates] SPA crawl completed: 23 pages analyzed ``` ### Example 4: Sitemap Analysis Crawl all URLs from a sitemap.xml file ``` > set url https://example.com/sitemap.xml URL set to: https://example.com/sitemap.xml > set is-sitemap true Sitemap mode enabled > crawl Parsing sitemap... Found 142 URLs in sitemap Starting crawl... [Progress updates] Sitemap crawl completed: 142 pages analyzed ``` ### Example 5: Competitive Analysis with AI Analyze competitors with OpenAI-powered insights ``` > set url https://competitor.com URL set to: https://competitor.com > set openai-api-key sk-proj-xxxxxxxxxxxxx OpenAI API key set OpenAI analyzer automatically enabled > set openai-model gpt-4o OpenAI model set to: gpt-4o > set openai-prompt Analyze this site's SEO strategy and content quality OpenAI prompt set > set max-pages 30 Max pages set to: 30 > crawl Starting crawl with AI analysis... [Crawl progress] [AI analysis results displayed] Crawl completed with AI insights ``` ### Example 6: Using Custom AI Prompts Load prompts from files for consistent analysis ``` > set url https://example.com URL set to: https://example.com > set anthropic-api-key sk-ant-xxxxxxxxxxxxx Anthropic API key set Anthropic analyzer automatically enabled > set anthropic-model claude-3-5-sonnet-20241022 Anthropic model set to: claude-3-5-sonnet-20241022 > set anthropic-prompt-file C:\Prompts\detailed-seo-audit.txt Anthropic prompt loaded from file > crawl Starting crawl with Claude analysis... [Progress and AI insights] ``` ### Example 7: Reviewing Past Crawls Access and export previous crawl data from database ``` > list crawls Crawl Database: C:\Reports\crawl.db ID | Session ID | URL | Start Time | Pages ----|--------------------------------------|------------------------|---------------------|------ 1 | abc123-def456-ghi789 | https://site1.com | 2026-02-10 14:30:00 | 127 2 | xyz789-uvw456-rst123 | https://site2.com | 2026-02-12 09:15:00 | 89 3 | mno345-pqr678-stu901 | https://site3.com | 2026-02-14 16:45:00 | 234 > export abc123-def456-ghi789 html-folder Exporting crawl session: abc123-def456-ghi789 Output type: html-folder Export completed: C:\Reports\site1-export\ ``` ### Example 8: Configuration Management Save and load project-specific settings ``` > show config Current Configuration: url: https://example.com output-dir: C:\Reports output-type: html-folder concurrent-requests: 10 rate-limit: 50 max-pages: 100 [... more settings ...] > save my-project-config.json [Save dialog opens] Configuration saved to: C:\Configs\my-project-config.json [Later session...] > load my-project-config.json [Open dialog opens] Configuration loaded from: C:\Configs\my-project-config.json All settings restored! ``` ### Example 9: Advanced Rate Limiting Control crawl speed to avoid overwhelming servers ``` > set url https://slow-server.com URL set to: https://slow-server.com > set concurrent-requests 5 Concurrent requests set to: 5 > set rate-limit 200 Rate limit set to: 200ms between requests > set max-pages 50 Max pages set to: 50 > crawl Starting crawl with rate limiting... [Slower, controlled progress] ``` ### Example 10: Multi-Provider AI Analysis Use multiple AI providers for comprehensive insights ``` > set url https://example.com URL set to: https://example.com > set openai-api-key sk-proj-xxxxxxxxxxxxx OpenAI API key set > set anthropic-api-key sk-ant-xxxxxxxxxxxxx Anthropic API key set > set gemini-api-key xxxxxxxxxxxxx Gemini API key set > set max-pages 20 Max pages set to: 20 > crawl Starting crawl with multiple AI analyzers... [Analysis from OpenAI, Anthropic, and Gemini] Multi-provider analysis completed ``` ## GUI Commands Reference ### Essential Commands | help | Show all available commands | | --- | --- | | version | Display application version | | clear | Clear output window | | exit / quit | Close application | ### Configuration Commands | show config | Display all current settings | | --- | --- | | set