xicv/browser-automation-skill

O que browser-automation-skill faz?

Uma skill do Claude Code para controlar navegadores reais por meio de quatro ferramentas roteadas (Chrome DevTools MCP, Playwright CLI, Playwright lib, Obscura). Credenciais locais em $HOME/.browser-skill/.

Visão Geral

Esta skill fornece um conjunto unificado de comandos para automação de navegador, utilizando as melhores ferramentas disponíveis para cada tarefa. Ela suporta interações com navegadores Chromium (Chrome, Edge), Firefox e WebKit (Safari) via Playwright, bem como controle de baixo nível via Chrome DevTools Protocol.

Ferramentas Roteadas

• Chrome DevTools MCP: Controle via Protocolo DevTools (CDP) para depuração, console, elementos e rede.
• Playwright CLI: Comandos rápidos para abrir navegadores, navegar e capturar screenshots sem código.
• Playwright lib: Automação programática com suporte a JavaScript/TypeScript para fluxos complexos.
• Obscura: Ferramenta auxiliar para tarefas complementares, como manipulação de cookies e sessões.

Pré-requisitos

• Node.js 18+ e npm (para Playwright)
• Google Chrome ou Chromium instalado (para DevTools MCP)
• Playwright: npx playwright install chromium

Instalação

1. Configure as credenciais locais: mkdir -p $HOME/.browser-skill/
2. Execute a skill no Claude Code: claude -p "Ativar automação de navegador"
3. A skill detecta automaticamente as ferramentas disponíveis.

Uso

Chrome DevTools MCP

# Abrir DevTools para uma URL
claude -p "Abra o DevTools para https://example.com e analise o console"

Playwright CLI

# Capturar um screenshot
claude -p "Capture um screenshot de https://example.com"

Playwright lib

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(await page.title());
  await browser.close();
})();

Configuração

• As credenciais ficam em $HOME/.browser-skill/credentials.json
• Variáveis de ambiente: BROWSER_SKILL_DEBUG=true para logs detalhados
• Suporta proxies: BROWSER_SKILL_PROXY=http://proxy:8080

Exemplos de Comandos

# Navegar e extrair dados
claude -p "Vá para https://news.ycombinator.com, encontre os 5 principais links e liste seus títulos"

# Interação básica
claude -p "Abra https://google.com, digite 'Claude Code' e clique em Pesquisar"

# Análise de DevTools
claude -p "Analise o tráfego de rede de https://example.com e identifique chamadas lentas"

Solução de Problemas

• Se o navegador não abrir, verifique se chromium está instalado.
• Erro de permissão: chmod +x $HOME/.browser-skill/*
• O Playwright requer dependências do sistema: npx playwright install-deps

Licença

MIT