Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Added new restructuing, redirects

avocardio4356f65575bc
diff --git a/docs/docs.json b/docs/docs.json
index 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.mdx
index 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>
+
## Features
1. Agent visits your target website
diff --git a/docs/examples/apps/vibetest-use.mdx b/docs/examples/apps/vibetest-use.mdx
index 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&nbsp; < 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)