--- title: "Getting Started - bseoa" description: "Install bseoa on Windows, macOS or Linux, activate your 14-day free trial, and run your first technical SEO crawl from the GUI or the command line." image: "https://www.blackseoanalyzer.com/static/images/black-seo-analyzer-og-image.png" canonical: "https://www.blackseoanalyzer.com/en/getting-started" language: "en" --- # 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) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.blackseoanalyzer.com/#organization","name":"Fiscus Technology, LLC","url":"https://www.blackseoanalyzer.com/","logo":"https://www.blackseoanalyzer.com/static/images/black-seo-analyzer.png","sameAs":["https://github.com/sethblack/black-seo-analyzer","https://www.youtube.com/@SethBlack","https://linkedin.com/in/seth-black-tx"],"founder":{"@type":"Person","@id":"https://www.blackseoanalyzer.com/#seth","name":"Seth Black","url":"https://www.blackseoanalyzer.com/about"}},{"@type":"WebSite","@id":"https://www.blackseoanalyzer.com/#website","name":"bseoa","url":"https://www.blackseoanalyzer.com/","publisher":{"@id":"https://www.blackseoanalyzer.com/#organization"}},{"@type":"WebPage","@id":"https://www.blackseoanalyzer.com/en/getting-started","url":"https://www.blackseoanalyzer.com/en/getting-started","name":"Getting Started - bseoa","description":"Install bseoa on Windows, macOS or Linux, activate your 14-day free trial, and run your first technical SEO crawl from the GUI or the command line.","inLanguage":"en-US","isPartOf":{"@id":"https://www.blackseoanalyzer.com/#website"}},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.blackseoanalyzer.com/"},{"@type":"ListItem","position":2,"name":"Getting Started","item":"https://www.blackseoanalyzer.com/en/getting-started"}]}]} ```