À propos du projet

invisible_playwright_mcp est un serveur MCP Python auto-hébergé qui permet à un assistant IA de piloter un vrai navigateur. Il repose sur un moteur Firefox furtif anti-détection, afin que l'agent puisse naviguer sur des pages qui bloqueraient autrement les clients automatisés. Deux façons de l'utiliser : 1. Via MCP depuis un assistant. Installez uv, puis ajoutez le plugin à Claude Code, Codex ou Gemini CLI via les commandes marketplace/extension documentées. Le paquet lui-même est le serveur MCP lorsqu'il est exécuté sans sous-commande. 2. Interface web autonome. Lancez `uvx invisible-playwright-mcp ui --openrouter-key ...` et ouvrez http://127.0.0.1:8765. Le chat se trouve à gauche, une vue en direct du navigateur à droite. Une clé OpenRouter est requise et le modèle par défaut est z-ai/glm-5.3-flash. L'agent pilote les pages comme le ferait une personne : en déplaçant le pointeur et en appuyant sur des touches plutôt qu'en appelant uniquement des API. L'exemple du README est une tâche de recherche de vols où l'agent doit cliquer sur les jours du calendrier un par un et lire les tarifs sans deviner. Les options de configuration incluent : - --openrouter-key ou OPENROUTER_API_KEY - --model ou INVISIBLE_MCP_MODEL - --proxy (http ou socks5, avec hôte et port requis ; fuseau horaire, locale et sortie suivent le proxy) - --binary pour une build existante du moteur, qui doit correspondre à la version épinglée - --seed pour une identité de navigateur reproductible - --profile-dir pour persister les connexions et les cookies - --headed pour afficher la fenêtre du navigateur - --host et --port (par défaut 127.0.0.1:8765 ; changer l'hôte expose une interface non authentifiée) Un fichier .env dans le répertoire courant peut contenir OPENROUTER_API_KEY et STEALTHFOX_BINARY. L'ordre de priorité est : flag, puis environnement, puis .env, puis valeur par défaut ; seul le répertoire courant est lu, et les valeurs ne sont pas affichées au démarrage. Projets liés dans la même famille : invisible_playwright (le moteur en tant que bibliothèque Python avec une API de style Playwright) et invisible_core (seed vers empreinte, préférences, proxy et géolocalisation). Notes de confidentialité du README : l'agent s'exécute localement sans serveur opéré par l'auteur. Les sites visités voient un Firefox normal ; le fournisseur du modèle reçoit la conversation et le contenu des pages ; GitHub est contacté pour télécharger le moteur, une base de données GeoIP lorsqu'un proxy est défini, et un compteur de lancement d'une ligne. Les sessions, profils et captures d'écran restent locaux sous INVISIBLE_MCP_HOME ou dans le répertoire de données applicatives du système. Le projet est sous licence MIT, les versions antérieures au 2 septembre 2026 restant sous AGPL-3.0. Le README demande également aux utilisateurs de respecter les conditions d'utilisation et les limites de débit des sites.