claude-chrome

# Claude Chrome — Browser Automation via Claude Code

Use Claude Code's Chrome integration to browse the web, interact with pages, and automate browser tasks. This is an alternative to OpenClaw's built-in browser tools (Chrome Relay, OpenClaw profile).

## Prerequisites

1. **Claude Code** installed on the node (e.g. `/opt/homebrew/bin/claude`)
2. **Claude Code Chrome extension** installed and enabled in Chrome
3. **Chrome** running on the node

## How It Works

Claude Code can connect to Chrome via its built-in browser extension (MCP server). When enabled, Claude Code gains browser tools — it can navigate pages, click elements, fill forms, read content, and more.

## Step 1: Check if Chrome Extension is Active

Look for the native host process to confirm the Chrome extension is running:

```bash
nodes.run node=<your-node-id> command='["bash", "-lc", "pgrep -f \"claude --chrome-native-host\""]'
```

If this returns a PID, the Chrome extension bridge is active and ready.

## Step 2: Run Claude Code with Chrome

Use `nodes.run` with your node to execute browser tasks:

```bash
nodes.run node=<your-node-id> commandTimeoutMs=120000 command='["bash", "-lc", "claude --dangerously-skip-permissions --chrome -p \"Go to example.com and read the headline\""]'
```

**Flags:**
- `--dangerously-skip-permissions` — auto-approve all actions (required for automation)
- `--chrome` — enable Chrome browser integration
- `-p` / `--print` — non-interactive print mode (required for automated use)
- `bash -lc` — login shell to ensure PATH is loaded

**Timeout:** See benchmarks below for guidance. Recommended defaults:
- Simple tasks (single page read): `commandTimeoutMs=30000` (30 seconds)
- Medium complexity (multi-step navigation): `commandTimeoutMs=120000` (2 minutes)
- Complex workflows (multiple pages + summarization): `commandTimeoutMs=180000` (3 minutes)

## Performance Benchmarks

| Task Type | Example | Duration | Recommended Timeout |
|-----------|---------|----------|-----------...