Browser

BT="python3 ~/.qwen/skills/browser/browser_tool.py"

# Launch (NOT background — it detaches automatically)
$BT launch                      # Playwright
$BT launch --patchright          # Anti-detection mode
$BT launch --connect 9222       # Attach to existing Chrome

# Navigation & interaction
$BT navigate "https://example.com"
$BT click "button.submit"
$BT type "input[name=email]" "[email protected]"
$BT type "input[name=email]" "[email protected]" --clear

# Observation
$BT snapshot                     # accessibility tree — structured text, token-efficient
$BT snapshot --selector "main"   # scoped to a section
$BT screenshot                   # saves /tmp/browser_screenshots/latest.png
$BT screenshot --name "step1"    # saves /tmp/browser_screenshots/step1.png
$BT screenshot --full            # full page
$BT html                         # get full page HTML
$BT html --selector "div.main"   # get element HTML
$BT evaluate "document.title"    # run JS

# Waiting
$BT wait --selector "div.loaded" --timeout 15

# Management
$BT pages                        # list tabs
$BT status                       # check if running
$BT close                        # kill browser

Rules

1. Launch first — always run launch before any other command
2. Use snapshot for AI reasoning — when you need to understand page structure, use snapshot first — it's faster and more accurate than screenshots
3. Use Patchright for sites with Cloudflare, DataDome, or other bot detection
4. Profile persists — user logs in once, stays logged in next time
5. launch is NOT blocking — it detaches the browser process and returns immediately