O que pixelcheck faz?
Primitivos de navegador MCP-first para agentes de IA — olhos e mãos reais na web. Local-first. Independente de fornecedor.
Visão Geral
O xcodethink/pixelcheck é um skill que expõe primitivos de navegador de baixo nível via Model Context Protocol (MCP). Ele permite que agentes de IA interajam com páginas da web como um humano faria: vendo a página (captura de tela), clicando em elementos, preenchendo formulários e navegando. Tudo executado localmente.
Funcionalidades Principais
- Captura de Tela: Tire screenshots de páginas web completas ou de elementos específicos.
- Interação com Elementos: Clique, digite, selecione e role a página.
- Navegação: Vá para URLs, volte, avance e atualize a página.
- Extração de Dados: Obtenha texto, atributos e conteúdo de elementos da página.
- Execução de JavaScript: Execute scripts personalizados no contexto da página.
Como Usar
Pré-requisitos
- Node.js 18+ instalado
- Um agente de IA compatível com MCP (ex: Claude Code, Cursor, Codex)
Instalação
npm install -g @xcodethink/pixelcheck
ou use diretamente:
npx @xcodethink/pixelcheck
Configuração
Adicione o skill ao seu arquivo de configuração MCP:
{
"skills": {
"pixelcheck": {
"command": "npx",
"args": ["@xcodethink/pixelcheck"]
}
}
}
Comandos
| Comando | Descrição |
|---|---|
screenshot | Tira um screenshot da página atual |
click | Clica em um elemento específico |
type | Digita texto em um campo |
navigate | Navega para uma URL |
getText | Obtém o texto de um elemento |
exemplo:
> navegue para https://exemplo.com
> screenshot
> clique no botão "Login"
Por que PixelCheck?
- Local-first: Seus dados e sessões ficam na sua máquina. Sem envio para nuvem.
- Vendor-agnostic: Funciona com Claude, Cursor, Codex e qualquer agente compatível com MCP.
- Baixa Latência: Interações rápidas sem depender de APIs externas.
- Transparente: Você vê exatamente o que o agente está fazendo no navegador.
Notas Técnicas
- Usa Playwright por baixo dos panos para automação de navegador headless.
- Suporta Chromium, Firefox e WebKit (configurável via ambiente).
- Variáveis de ambiente:
PIXELCHECK_BROWSER(chrome/firefox/webkit),PIXELCHECK_HEADLESS(true/false).
Links
- Repositório: https://github.com/xcodethink/pixelcheck
- Documentação: https://pixelcheck.dev
- MCP Spec: https://modelcontextprotocol.io