Skip to content

v0.1.0-rc.2: Black Sparrow Rebrand & Initial Engine Release

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Sep 05:16
v0.1.0-rc.2
7021825

🦅 Black Sparrow v0.1.0-rc.2: Initial Rebrand & Engine Release

Welcome to Black Sparrow (blacksparrow)! This milestone marks the official rebrand from seo-lens to Black Sparrow, introducing a modernized Cyberpunk visual identity, native terminal alias sparrow, and centralized branding decoupling.

Black Sparrow is a blazing-fast, local-first website crawler, 120-rule technical SEO audit engine, and AI-native auditor written in pure Rust.

🚀 Quick Install

macOS & Linux (Universal Installer)

Installs the standalone blacksparrow binary and automatically creates the sparrow terminal alias in ~/.local/bin:

curl -fsSL https://raw.githubusercontent.com/Shantodotdev/blacksparrow/main/install.sh | bash

Windows (PowerShell)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/Shantodotdev/blacksparrow/releases/download/v0.1.0-rc.2/blacksparrow-installer.ps1 | iex"

Windows users can also download the standalone .msi installer attached below.

✨ What's New in v0.1.0-rc.2

1. 🦅 Rebrand to Black Sparrow

  • Crate & Binary: Primary crate and binary renamed to blacksparrow.
  • Terminal Alias: Native support for the short sparrow alias alongside blacksparrow.
  • Repository: Updated remote to https://github.com/Shantodotdev/blacksparrow.

2. 🎨 Neon Pink & Deep Maroon Visual Identity

  • Terminal UI: Cyberpunk palette with Neon Pink (#ff2a85 / ANSI 198) and Deep Maroon (#831843 / ANSI 161).
  • Interactive HTML Dashboard: Rebranded dark obsidian canvas (#0d070f), glowing pink accents, and standalone zero-dependency charts.
  • ASCII Art Banner: Clean SPARROW header across the CLI, installer, and HTML reports.

3. 🧩 Reusable Engine & Decoupled Branding

  • Introduced src/core/branding.rs centralizing User-Agents (BlackSparrow/1.0), server tokens, database paths (.blacksparrow/blacksparrow.db), and CLI metadata.
  • Preserved full backwards compatibility with legacy .seolens/seolens.db databases and SEOLENS_DB_PATH.

4. 📦 Packaging & Tooling

  • Updated WiX toolset configuration to produce standalone blacksparrow.exe Windows MSI installers.
  • Automated release build matrix for Linux (x86_64, aarch64), macOS (Apple Silicon, Intel), and Windows.

⚡ Core Architecture & Capabilities

  • Zero-Copy Streaming HTML Parser: Cloudflare's lol_html CSS-selector streaming tokenizer processes 500–800 pages/sec in < 50 MB RAM.
  • AIMD Adaptive Congestion Control: Additive-Increase / Multiplicative-Decrease politeness algorithm dynamically regulates request rates based on target latency and HTTP 429/503 signals.
  • 120-Rule SEO Audit Catalog: Diagnostic heuristics covering HTTP transport, metadata, headings, canonicalization, links, security headers, mobile UX, and Google Rich Results structured data.
  • GEO & AI Search Readiness: Audits /llms.txt, tests AI search citation permissions (GPTBot, ClaudeBot, PerplexityBot), and flags bot-challenge screens.
  • Petgraph Topology & PageRank: Post-crawl directed link graph calculation identifies orphaned pages and internal link equity distribution hubs.
  • Model Context Protocol (MCP): Embedded JSON-RPC 2.0 stdio server providing 8 native tools for autonomous AI coding agents (Claude, Cursor, Windsurf).
  • Local-First SQLite Persistence: Embedded SQLite with WAL mode, non-blocking asynchronous batching, and zero telemetry.

🛠️ CLI Quickstart

# Full website crawl with 500-page limit & AIMD rate limiting
sparrow audit https://example.com --max-pages 500

# Fast single-page developer X-ray
sparrow inspect https://example.com/pricing --format json

# Generative Engine Optimization & AI bot readiness check
sparrow check-ai https://example.com

# Validate JSON-LD Schema.org against Google Rich Results
sparrow schema https://example.com/products/item-1

# Launch native Model Context Protocol server for AI coding agents
sparrow mcp

📦 Verified Assets & SHA-256 Checksums

All platform binaries and packages are cryptographically verified via sha256.sum.

Assets 20
Loading