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

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

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 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 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 →

Community Support

Join discussions, share tips, and get help from the community.

Visit Forum →

Video Tutorials

Watch step-by-step guides and advanced technique tutorials.

Watch Videos →

Ready to Get Started?

Download bseoa today and start improving your website's SEO.

Download Now View Full Docs