# Browser Automation

Controls a browser over CDP for automation, scraping, testing and screenshots.

- Repository: https://github.com/browser-use/browser-use (119761 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add browser-use/browser-use --skill browser-use -g -a claude-code -y`
Codex: `npx skills add browser-use/browser-use --skill browser-use -g -a codex -y`
Cursor: `npx skills add browser-use/browser-use --skill browser-use -g -a cursor -y`
Gemini CLI: `npx skills add browser-use/browser-use --skill browser-use -g -a gemini-cli -y`

## Description

Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work. Also covers hosted cloud browsers for AI agents: the browser-use Python library (Browser(use_cloud=True)), Playwright, Puppeteer or any CDP client.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Browser Use

Direct browser control via CDP. For task-specific edits, use `agent-workspace/agent_helpers.py`. For setup, install, or connection problems, read https://github.com/browser-use/browser-harness/blob/main/install.md.

## When Not to Use

A basic fetch of public information needs no browser. If a plain HTTP request can read it, a public page, an API, docs, use `curl` or your fetch tool, and leave the browser alone. Use browser-use when the task needs interaction (click, type, navigate), the user's logged-in session, JS rendering, or a bot-protected page. If a direct fetch fails or returns a shell page, then escalate to the browser.

Domain skills are off by default. Set `BH_DOMAIN_SKILLS=1` to enable them; see the bottom section.

**If `BH_DOMAIN_SKILLS=1` and the task is site-specific, read every file in the matching `$BH_AGENT_WORKSPACE/domain-skills/<site>/` directory before inventing an approach.**

## Usage

```bash
browser-use <<'PY'
print(page_info())
PY
```

The rest: https://github.com/browser-use/browser-use/blob/HEAD/browser_use/skills/browser-use/SKILL.md