|
1 | 1 | ---
|
2 |
| -title: "QA-Testing (Vibetest-Use)" |
3 |
| -description: "WIP" |
4 |
| -icon: "vial" |
| 2 | +title: "Vibetest-Use (Automated QA)" |
| 3 | +description: "Run multi-agent Browser-Use tests to catch UI bugs, broken links, and accessibility issues before they ship." |
| 4 | +icon: "bug" |
5 | 5 | mode: "wide"
|
6 | 6 | ---
|
7 | 7 |
|
8 |
| -WIP |
| 8 | +<Note> |
| 9 | +Requires **browser-use < v0.5.0** and Playwright Chromium. Currently getting an update to v0.7.6+. |
| 10 | +</Note> |
| 11 | + |
| 12 | +<video |
| 13 | + controls |
| 14 | + className="w-full aspect-video rounded-xl" |
| 15 | + src="https://github.com/user-attachments/assets/6450b5b7-10e5-4019-82a4-6d726dbfbe1f"> |
| 16 | +</video> |
| 17 | + |
| 18 | +## Features |
| 19 | + |
| 20 | +1. Launches multiple headless (or visible) Browser-Use agents in parallel |
| 21 | +2. Crawls your site and records screenshots, broken links & a11y issues |
| 22 | +3. Works on production URLs *and* `localhost` dev servers |
| 23 | +4. Simple natural-language prompts via MCP in Cursor / Claude Code |
| 24 | + |
| 25 | +## Quick Start |
| 26 | + |
| 27 | +```bash |
| 28 | +# 1. Create & activate env |
| 29 | +uv venv --python 3.11 |
| 30 | +source .venv/bin/activate |
| 31 | + |
| 32 | +# 2. Install project |
| 33 | +uv pip install -e . |
| 34 | + |
| 35 | +# 3. Install browser runtime once |
| 36 | +playwright install chromium --with-deps --no-shell |
| 37 | +``` |
| 38 | + |
| 39 | +### 1) Claude Code |
| 40 | + |
| 41 | +```bash |
| 42 | +# Register the MCP server |
| 43 | +claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp \ |
| 44 | + -e GOOGLE_API_KEY="your_api_key" |
| 45 | + |
| 46 | +# Inside a Claude chat |
| 47 | +> /mcp |
| 48 | +# ⎿ MCP Server Status |
| 49 | +# • vibetest: connected |
| 50 | +``` |
| 51 | + |
| 52 | +### 2) Cursor (manual MCP entry) |
| 53 | + |
| 54 | +1. Open **Settings → MCP** |
| 55 | +2. Click **Add Server** and paste: |
| 56 | + |
| 57 | +```json |
| 58 | +{ |
| 59 | + "mcpServers": { |
| 60 | + "vibetest": { |
| 61 | + "command": "/full/path/to/vibetest-use/.venv/bin/vibetest-mcp", |
| 62 | + "env": { |
| 63 | + "GOOGLE_API_KEY": "your_api_key" |
| 64 | + } |
| 65 | + } |
| 66 | + } |
| 67 | +} |
| 68 | +``` |
| 69 | + |
| 70 | +## Basic Prompts |
| 71 | +``` |
| 72 | +> Vibetest my website with 5 agents: browser-use.com |
| 73 | +> Run vibetest on localhost:3000 |
| 74 | +> Run a headless vibetest on localhost:8080 with 10 agents |
| 75 | +``` |
| 76 | + |
| 77 | +### Parameters |
| 78 | +* **URL** – any `https` or `http` host or `localhost:port` |
| 79 | +* **Agents** – `3` by default; more agents = deeper coverage |
| 80 | +* **Headless** – say *headless* to hide the browser, omit to watch it live |
| 81 | + |
| 82 | +## Requirements |
| 83 | + |
| 84 | +* Python 3.11+ |
| 85 | +* Google API key (Gemini flash used for analysis) |
| 86 | +* Cursor / Claude with MCP support |
| 87 | + |
| 88 | +## Source Code |
| 89 | + |
| 90 | +Full implementation: [https://github.com/browser-use/vibetest-use](https://github.com/browser-use/vibetest-use) |
0 commit comments