Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
Added new restructuing, redirects
avocardio4356f65575bc
diff --git a/docs/docs.json b/docs/docs.jsonindex 38674ef72..7f5b3cb80 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -74,6 +74,42 @@{"source": "/customize/examples/chain-agents","destination": "/customize/examples/follow-up-tasks"+ },+ {+ "source": "/customize/examples/fast-agent",+ "destination": "/examples/templates/fast-agent"+ },+ {+ "source": "/customize/examples/follow-up-tasks",+ "destination": "/examples/templates/follow-up-tasks"+ },+ {+ "source": "/customize/examples/parallel-browser",+ "destination": "/examples/templates/parallel-browser"+ },+ {+ "source": "/customize/examples/playwright-integration",+ "destination": "/examples/templates/playwright-integration"+ },+ {+ "source": "/customize/examples/sensitive-data",+ "destination": "/examples/templates/sensitive-data"+ },+ {+ "source": "/customize/examples/secure",+ "destination": "/examples/templates/secure"+ },+ {+ "source": "/customize/examples/more-examples",+ "destination": "/examples/templates/more-examples"+ },+ {+ "source": "/customize/examples/ad-use",+ "destination": "/examples/apps/ad-use"+ },+ {+ "source": "/customize/examples/vibetest-use",+ "destination": "/examples/apps/vibetest-use"}],"navigation": {diff --git a/docs/examples/apps/ad-use.mdx b/docs/examples/apps/ad-use.mdxindex c326502ac..f62beffe5 100644--- a/docs/examples/apps/ad-use.mdx+++ b/docs/examples/apps/ad-use.mdx@@ -1,5 +1,5 @@----title: "Ad Generator (Ad-Use)"+title: "Ad-Use (Ad Generator)"description: "Generate Instagram ads from landing pages using browser agents and Google's Nano Banana 🍌."icon: "image"mode: "wide"@@ -9,6 +9,12 @@ mode: "wide"This demo requires browser-use v0.7.6+.</Note>+<video+ controls+ className="w-full aspect-video rounded-xl"+ src="https://github.com/user-attachments/assets/7fab54a9-b36b-4fba-ab98-a438f2b86b7e">+</video>+## Features1. Agent visits your target websitediff --git a/docs/examples/apps/vibetest-use.mdx b/docs/examples/apps/vibetest-use.mdxindex 8d20ab4d9..3adbb902d 100644--- a/docs/examples/apps/vibetest-use.mdx+++ b/docs/examples/apps/vibetest-use.mdx@@ -1,8 +1,90 @@----title: "QA-Testing (Vibetest-Use)"-description: "WIP"-icon: "vial"+title: "Vibetest-Use (Automated QA)"+description: "Run multi-agent Browser-Use tests to catch UI bugs, broken links, and accessibility issues before they ship."+icon: "bug"mode: "wide"----WIP+<Note>+Requires **browser-use < v0.5.0** and Playwright Chromium. Currently getting an update to v0.7.6+.+</Note>++<video+ controls+ className="w-full aspect-video rounded-xl"+ src="https://github.com/user-attachments/assets/6450b5b7-10e5-4019-82a4-6d726dbfbe1f">+</video>++## Features++1. Launches multiple headless (or visible) Browser-Use agents in parallel+2. Crawls your site and records screenshots, broken links & a11y issues+3. Works on production URLs *and* `localhost` dev servers+4. Simple natural-language prompts via MCP in Cursor / Claude Code++## Quick Start++```bash+# 1. Create & activate env+uv venv --python 3.11+source .venv/bin/activate++# 2. Install project+uv pip install -e .++# 3. Install browser runtime once+playwright install chromium --with-deps --no-shell+```++### 1) Claude Code++```bash+# Register the MCP server+claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp \+ -e GOOGLE_API_KEY="your_api_key"++# Inside a Claude chat+> /mcp+# ⎿ MCP Server Status+# • vibetest: connected+```++### 2) Cursor (manual MCP entry)++1. Open **Settings → MCP**+2. Click **Add Server** and paste:++```json+{+ "mcpServers": {+ "vibetest": {+ "command": "/full/path/to/vibetest-use/.venv/bin/vibetest-mcp",+ "env": {+ "GOOGLE_API_KEY": "your_api_key"+ }+ }+ }+}+```++## Basic Prompts+```+> Vibetest my website with 5 agents: browser-use.com+> Run vibetest on localhost:3000+> Run a headless vibetest on localhost:8080 with 10 agents+```++### Parameters+* **URL** – any `https` or `http` host or `localhost:port`+* **Agents** – `3` by default; more agents = deeper coverage+* **Headless** – say *headless* to hide the browser, omit to watch it live++## Requirements++* Python 3.11++* Google API key (Gemini flash used for analysis)+* Cursor / Claude with MCP support++## Source Code++Full implementation: [https://github.com/browser-use/vibetest-use](https://github.com/browser-use/vibetest-use)