bonk

A fast, stealth-first browser automation library for Go. Direct Chrome DevTools Protocol over WebSocket — no WebDriver, no relay, no detection.

Documentation

Features

• Direct CDP — WebSocket to Chrome, zero intermediaries, undetectable by default
• Stealth by default — skips Runtime.enable, patches navigator/plugins/WebGL, strips headless signals
• Code-generated protocol bindings — full coverage of all 55 CDP domains from upstream .pdl files
• Context-aware — page.WithContext(ctx) / page.Timeout(d) for deadlines and cancellation
• Auto-wait elements — polls for visibility before interaction, retries stale references
• Network interception — intercept, modify, mock, or block requests and responses via the Fetch domain
• Device emulation — built-in presets for iPhone 15, Pixel 8, iPad Pro, Galaxy S23, and more
• Session persistence — save and restore cookies and localStorage across runs
• Isolated contexts — separate cookie jars, proxies, viewports, and locales per context
• Single dependency — only coder/websocket

Installation

go get github.com/joakimcarlsson/bonk

Quick Start

package main

import (
    "fmt"
    "log"

    "github.com/joakimcarlsson/bonk"
)

func main() {
    b, err := bonk.Launch()
    if err != nil {
        log.Fatal(err)
    }
    defer b.Close()

    ctx, err := b.NewContext()
    if err != nil {
        log.Fatal(err)
    }

    page, err := ctx.NewPage()
    if err != nil {
        log.Fatal(err)
    }

    if err := page.Navigate("https://example.com"); err != nil {
        log.Fatal(err)
    }

    title, _ := page.Title()
    fmt.Println(title)
}

License

See LICENSE file.