| 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");
const markdown = await page.markdown();
console.log(markdown);
await page.close();
Google Search Reconnaissance
import { google } from "@aphrody-code/bxc/google";
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).
