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.

Still Have Questions?

We're here to help. Check out our documentation or reach out directly.