Sobre o projeto

invisible_playwright_mcp é um servidor MCP Python auto-hospedado que permite a um assistente de IA controlar um navegador real. Ele é construído sobre um motor Firefox furtivo anti-detecção, para que o agente possa navegar em páginas que de outra forma bloqueariam clientes automatizados. Duas formas de usá-lo: 1. Via MCP a partir de um assistente. Instale o uv e adicione o plugin ao Claude Code, Codex ou Gemini CLI pelos comandos documentados de marketplace/extensão. O próprio pacote é o servidor MCP quando executado sem um subcomando. 2. Interface web autônoma. Execute `uvx invisible-playwright-mcp ui --openrouter-key ...` e abra http://127.0.0.1:8765. O chat fica à esquerda, uma visualização ao vivo do navegador à direita. Requer uma chave OpenRouter e usa por padrão o modelo z-ai/glm-5.3-flash. O agente controla as páginas como uma pessoa faria: movendo o ponteiro e pressionando teclas em vez de apenas chamar APIs. O exemplo do README é uma tarefa de busca de voos em que o agente precisa clicar nos dias do calendário um a um e ler as tarifas sem adivinhar. As opções de configuração incluem: - --openrouter-key ou OPENROUTER_API_KEY - --model ou INVISIBLE_MCP_MODEL - --proxy (http ou socks5, com host e porta obrigatórios; fuso horário, locale e egress seguem o proxy) - --binary para uma build existente do motor, que deve corresponder à versão fixada - --seed para uma identidade de navegador reproduzível - --profile-dir para persistir logins e cookies - --headed para mostrar a janela do navegador - --host e --port (padrões 127.0.0.1:8765; alterar o host expõe uma interface sem autenticação) Um arquivo .env no diretório atual pode conter OPENROUTER_API_KEY e STEALTHFOX_BINARY. A precedência é flag, depois ambiente, depois .env, depois padrão; apenas o diretório atual é lido, e os valores não são impressos na inicialização. Projetos relacionados da mesma família: invisible_playwright (o motor como biblioteca Python com uma API no estilo Playwright) e invisible_core (seed para fingerprint, preferências, proxy e geolocalização). Notas de privacidade do README: o agente roda localmente sem servidor operado pelo autor. Os sites visitados veem um Firefox normal; o provedor do modelo recebe a conversa e o conteúdo da página; o GitHub é contatado para baixar o motor, um banco de dados GeoIP quando um proxy é definido, e um contador de inicialização de uma linha. Sessões, perfis e capturas de tela permanecem locais sob INVISIBLE_MCP_HOME ou o diretório de dados de aplicativos do sistema. O projeto é licenciado sob MIT, com versões anteriores a 2 de setembro de 2026 permanecendo AGPL-3.0. O README também pede que os usuários respeitem os termos dos sites e os limites de taxa.