Better Browser Use banner
yoloshii yoloshii

Better Browser Use

Development community

Description

A hybrid SOTA browser use skill with tiered stealth escalation and turnstyle captcha trigger-avoidance. Includes early WebMCP functionality.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

better-browser-use

Agentic browser automation with ARIA snapshots, three stealth tiers, and human-like behavior simulation.

An AI agent controls the browser by observing ARIA accessibility trees (not screenshots or HTML), reasoning about page state, and executing actions through element refs. Sessions persist cookies, storage, and fingerprints across runs. Anti-bot protection is handled through progressive stealth escalation.

How It Works

Agent                          Server                         Browser
  │                              │                              │
  ├─ launch(tier=1, url) ──────►│─── open browser ────────────►│
  │◄──── {session_id} ──────────│                               │
  │                              │                              │
  ├─ snapshot ──────────────────►│─── ARIA tree ───────────────►│
  │◄──── @e1 link "Login"       │◄── {tree, refs} ─────────────│
  │      @e2 input "Email"      │                              │
  │      @e3 button "Submit"    │                              │
  │                              │                              │
  ├─ click @e1 ─────────────────►│─── humanized click ─────────►│
  │◄──── {page_changed: true}    │◄── result ───────────────────│
  │                              │                              │
  ├─ snapshot ──────────────────►│   (new refs after nav)       │
  │◄──── @e4 input "Password"   │                              │
  │      ...                     │                              │

The agent loop: **snapshot** (observe) → **reason** (decide) → **act** (execute) → repeat.

Quick Start

Install

git clone https://github.com/yoloshii/better-browser-use.git
cd better-browser-use

# Use an isolated environment — the deps are version-pinned (playwright <1.56,
# plus a pyee override) and will conflict with globally-installed packages.
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate

pip install cloakbrowser 'pye