# webqa-agent

> webqa-agent is an open-source agent for browser automation. Autonomous web testing agent that checks functionality, performance, UX and security. It is available on CLI, Web, self-hosted and API.

- **Kind:** Agent
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted, API
- **Repository:** https://github.com/migoxlab/webqa-agent
- **GitHub stars:** 240
- **License:** Apache-2.0
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

WebQA Agent drops the test script: you state a goal in one sentence and it drives a browser to try it, using multimodal understanding of the page. The README describes three forms of testing, a lightweight Flash mode for quick smoke tests, a Standard Generate mode that discovers pages and plans tests (focused when you give goals, exploratory when you do not), and a Run mode that executes YAML instructions for repeatable regression checks.

It can be used from a CLI, a web dashboard, or from coding agents such as Cursor and Claude Code through MCP or a skill. For teams, a Docker Compose deployment adds a dashboard with test management and history; you supply an LLM API key in the environment file.

It is a Python project under Apache-2.0, with a Discord and WeChat community linked from the README.

## Features

- **Flash mode:** Turns a one-sentence goal into a quick browser test.
- **Generate mode:** Discovers the site and plans tests, either focused on goals or exploratory.
- **Run mode:** Executes YAML steps with expected checks for regression testing.
- **MCP and skill access:** Lets Cursor, Claude Code and similar agents trigger tests.
- **Docker Compose dashboard:** Adds test management and run history for teams.

## Good for

- Smoke-test a new feature from inside an IDE
- Explore a freshly built site for broken flows
- Re-run a fixed regression checklist before release
- Audit pages for performance and security issues

## FAQ

### Do I need to write test scripts?

No, Flash and Generate modes work from a natural-language goal.

### How do I run it with a dashboard?

Copy the example .env, add your LLM API key and run the start script in deploy/docker-compose.

### Can coding agents call it?

Yes, through MCP or a skill, as the README describes.

### Is webqa-agent free?

Yes. webqa-agent is open source, so you can use and self-host it for free.

### What are the best alternatives to webqa-agent?

The closest alternatives to webqa-agent are deepseek-harness, gemini-cli, learn-claude-code, Codewhale and oh-my-pi.

## Alternatives

- [deepseek-harness](https://ai-powered.com/agents/deepseek-harness): deepseek-harness is an open-source agent for multi-agent frameworks.
- [gemini-cli](https://ai-powered.com/agents/gemini-cli): gemini-cli is an open-source agent for ai models and llm tooling.
- [learn-claude-code](https://ai-powered.com/agents/learn-claude-code): learn-claude-code is an open-source hosted agent for ai models and llm tooling.
- [Codewhale](https://ai-powered.com/agents/codewhale): Codewhale is an open-source agent for coding.
- [oh-my-pi](https://ai-powered.com/agents/oh-my-pi): oh-my-pi is an open-source agent for coding.
- [openclaude](https://ai-powered.com/agents/openclaude): openclaude is an open-source agent for coding.
- [qwen-code](https://ai-powered.com/agents/qwen-code): qwen-code is an open-source agent for coding.
- [stagehand](https://ai-powered.com/agents/stagehand): stagehand is an open-source agent framework for browser automation.

---
Source: https://ai-powered.com/agents/webqa-agent
