bxc

name	bxc
description	bxc (Zero-Spawn Browser Engine) is a high-performance browser automation & scraping engine (Bun + Rust/Zig + native Chromium). Use this skill when scraping URLs, executing JS in a stealth environment, performing website reconnaissance, or detecting framework tech stacks.

Bxc: Zero-Spawn Browser Engine

bxc is a high-concurrency browser engine designed specifically for AI agents, running browser logic in-process via Bun + Rust/Zig without spawning heavy Chromium processes.

Key Concepts

• Zero-Spawn: Runs Chromium/Lightpanda DOM directly in the Bun runtime thread using FFI (Fast Foreign Function Interface), avoiding process overhead.
• Stealth Profiles: Features native stealth configurations that bypass cloud-mitigation networks and bot detectors.
• Scrape-to-Markdown: Directly compiles raw HTML DOM trees into clean, semantic Github Flavored Markdown (GFM) to minimize LLM token consumption.
• Google Atlas: Smart routing layer that auto-tunes localization and parameters for search queries.

CLI Usage

Command	Syntax	Description
scrape	bxc scrape <url> --markdown	Convert a URL directly to Markdown.
recon	bxc recon <url>	Get full tech stack metadata, assets, and markdown.
detect	bxc detect <url>	Deep CMS, WAF, and framework detection.
serve	bxc serve --cdp-port 9222	Spawn a Chrome DevTools Protocol (CDP) server.

Library API Examples

Basic Stealth Navigation

import { Browser } from "@aphrody-code/bxc";

const page = await Browser.newPage({ profile: "stealth" });
await page.goto("https://example.com");

// Output page directly as Markdown
const markdown = await page.markdown();
console.log(markdown);

await page.close();

Google Search Reconnaissance

import { google } from "@aphrody-code/bxc/google";

// Opens a search result with Google Smart Routing
const { page } = await google.open("https://www.google.com/search?q=bxc+engine");
const content = await page.content();
await page.close();

Troubleshooting & Search Queries

• WAF Blocks: If a site blocks navigation, verify the --insecure CLI flag is set, or switch the profile to stealth.
• Lightpanda Engine Setup: Run bxc install to download/refresh the native Lightpanda Zig dynamic libraries (liblightpanda_dom).