Sobre el proyecto

invisible_playwright_mcp es un servidor MCP de Python autohospedado que permite a un asistente de IA controlar un navegador real. Está construido sobre un motor Firefox sigiloso anti-detección, de modo que el agente puede navegar por páginas que de otro modo bloquearían a los clientes automatizados. Dos formas de usarlo: 1. A través de MCP desde un asistente. Instala uv y luego añade el complemento a Claude Code, Codex o Gemini CLI mediante los comandos documentados de marketplace/extensión. El propio paquete es el servidor MCP cuando se ejecuta sin un subcomando. 2. Interfaz web independiente. Ejecuta `uvx invisible-playwright-mcp ui --openrouter-key ...` y abre http://127.0.0.1:8765. El chat se sitúa a la izquierda y una vista en vivo del navegador a la derecha. Requiere una clave de OpenRouter y utiliza por defecto el modelo z-ai/glm-5.3-flash. El agente controla las páginas como lo haría una persona: moviendo el puntero y pulsando teclas en lugar de limitarse a llamar a las API. El ejemplo del README es una tarea de búsqueda de vuelos en la que el agente debe hacer clic en los días del calendario uno a uno y leer las tarifas sin adivinar. Las opciones de configuración incluyen: - --openrouter-key o OPENROUTER_API_KEY - --model o INVISIBLE_MCP_MODEL - --proxy (http o socks5, con host y puerto obligatorios; la zona horaria, la configuración regional y la salida siguen al proxy) - --binary para una compilación existente del motor, que debe coincidir con la versión fijada - --seed para una identidad de navegador reproducible - --profile-dir para conservar inicios de sesión y cookies - --headed para mostrar la ventana del navegador - --host y --port (valores predeterminados 127.0.0.1:8765; cambiar el host expone una interfaz sin autenticación) Un archivo .env en el directorio actual puede contener OPENROUTER_API_KEY y STEALTHFOX_BINARY. La precedencia es: bandera, luego variable de entorno, luego .env y luego valor predeterminado; solo se lee el directorio actual y los valores no se imprimen al iniciar. Proyectos relacionados de la misma familia: invisible_playwright (el motor como biblioteca de Python con una API estilo Playwright) e invisible_core (semilla para huella digital, preferencias, proxy y geolocalización). Notas de privacidad del README: el agente se ejecuta localmente sin ningún servidor operado por el autor. Los sitios visitados ven un Firefox normal; el proveedor del modelo recibe la conversación y el contenido de la página; se contacta con GitHub para descargar el motor, una base de datos GeoIP cuando se configura un proxy y un contador de lanzamientos de una línea. Las sesiones, los perfiles y las capturas de pantalla permanecen locales en INVISIBLE_MCP_HOME o en el directorio de datos de aplicaciones del sistema. El proyecto tiene licencia MIT, y las versiones anteriores al 2 de septiembre de 2026 permanecen bajo AGPL-3.0. El README también pide a los usuarios que respeten los términos de los sitios y los límites de frecuencia.