convez.ai
MCP ServerAutomaçãoIntermediário
hu-qi

QWebBridge

hu-qi/QWebBridge

Controle Chrome com IA — navegue, clique, preencha, capture screenshots

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que funciona como ponte entre agentes de IA e navegadores Chrome, permitindo controle completo via árvore de acessibilidade. Oferece navegação, cliques, preenchimento de formulários, capturas de tela e execução de JavaScript através de WebSocket, HTTP ou MCP.

Instalação

$npx convez-ai hu-qi/QWebBridge

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
2
Acompanhando
1
Saúde
28%
Último commit
há 1 mês
Versão
v1.1.0
Issues abertas
12
Contribuidores
2

Casos de uso

  • Automação de tarefas web com agentes de IA
  • Teste automatizado de interfaces web
  • Scrapin web assistido por IA com interação real
  • RPA (Robotic Process Automation) integrado a agentes Claude

Veredito

Ferramenta robusta e bem arquitetada para automação web com IA. Suporta múltiplos protocolos (WebSocket, HTTP, MCP) e oferece controle granular do navegador via accessibility tree, ideal para agentes que precisam interagir com interfaces reais de forma confiável.

README

A tradução para o português deste README ainda está na fila.

QwebBridge

Browser bridge for AI agents. Let AI agents control your real browser — navigate, click, fill, screenshot, and more.

Architecture

AI Agent → Daemon (Node.js, localhost:10086) → Chrome Extension (CDP) → Browser

Quick Start

Install (recommended)

curl -fsSL https://github.com/hu-qi/QWebBridge/raw/main/install.sh | bash

Manual

# 1. Install deps and build
pnpm install
pnpm build

# 2. Start the daemon
node packages/daemon/dist/cli.js run

# 3. Load extension in Chrome
#    - Open chrome://extensions
#    - Enable "Developer mode"
#    - Click "Load unpacked"
#    - Select packages/extension/dist

# 4. Connect an AI agent
#    WebSocket: ws://localhost:10086/selector/command
#    HTTP POST: curl -X POST http://localhost:10086/api/tool/navigate -H 'Content-Type: application/json' -d '{"url":"https://example.com"}'

CLI

qweb-bridge status          # Show daemon status
qweb-bridge start           # Start daemon (background)
qweb-bridge stop            # Stop daemon
qweb-bridge restart         # Restart daemon
qweb-bridge logs -n 100     # View logs
qweb-bridge logs -f         # Follow logs
qweb-bridge install-skill   # Install AI agent skill
qweb-bridge uninstall       # Remove all data

Tools

ToolDescription
navigateNavigate to URL, open new tabs
snapshotGet page accessibility tree
screenshotCapture page screenshot
clickClick element by selector or ref
fillFill form inputs
evaluateExecute JavaScript
mouse_clickReal mouse click with coordinates
key_typeType text character by character
send_keysSend keyboard shortcuts
uploadUpload files to file inputs
networkMonitor network requests
find_tabFind tab by URL
list_tabsList all tabs
close_tabClose a specific tab
close_sessionClose all tabs in a session
save_as_pdfSave page as PDF

Agent Integration

  • WebSocket: Connect to ws://localhost:10086/selector/command
  • MCP: Run qweb-bridge mcp for Claude Desktop / Cursor
  • HTTP REST: POST /api/tool/<name>
  • CLI: qweb-bridge navigate --url https://example.com

AI Agent Skill

QwebBridge ships with an agent skill for AI-assisted development environments:

bash packages/skill/install.sh

This installs the skill to ~/.agents/skills/qweb-bridge/, making it auto-discoverable by AI agents. The skill provides:

  • Full 16-tool reference with params, return values, and call examples
  • Session management and tab group conventions
  • Screenshot helper script (avoids base64 context flooding)
  • Operations guide for install, start, and troubleshooting

License

MIT

Ver o original no GitHub

Bom para

Relacionados