Les commandes à connaître pour Agent Browser, le CLI de Vercel Labs qui permet à Claude Code ou Codex de piloter un vrai navigateur Chrome : ouvrir une page, lire sa structure, cliquer, remplir, capturer.

Installation

npm install -g agent-browser     # ou : brew install agent-browser / cargo install agent-browser
agent-browser install            # télécharge Chrome for Testing (première fois)
 
# Ajouter la skill à Claude Code, Codex, Cursor…
npx skills add vercel-labs/agent-browser

La skill installée est un simple pointeur vers agent-browser skills get core : les instructions suivent toujours la version du CLI installée. Ne pas copier le SKILL.md depuis node_modules, il deviendrait obsolète.

Le workflow de base (à mettre dans CLAUDE.md)

  1. agent-browser open <url> — ouvrir la page
  2. agent-browser snapshot -i — lister les éléments interactifs, chacun avec une référence (@e1, @e2…)
  3. agent-browser click @e1 / agent-browser fill @e2 "texte" — agir via les références
  4. Refaire un snapshot après chaque changement de page

Commandes principales

CommandeCe qu’elle fait
agent-browser open <url>Lance le navigateur et ouvre l’URL.
agent-browser snapshot -iArbre d’accessibilité limité aux éléments interactifs, avec références. La commande la plus utile pour un agent.
agent-browser snapshot -i -c -d 5Idem, compacté (-c) et limité en profondeur (-d) pour économiser des tokens.
agent-browser read [url]Récupère le texte lisible d’une page (Markdown si disponible), sans lancer Chrome.
agent-browser get text @e1Texte d’un élément. Aussi get url, get title, get value, get html.
agent-browser back / forward / reloadNavigation.

Agir

CommandeCe qu’elle fait
agent-browser click @e2Clique sur un élément.
agent-browser fill @e3 "a@b.com"Vide puis remplit un champ.
agent-browser type @e3 "texte"Tape dans un champ sans le vider.
agent-browser press EnterAppuie sur une touche.
agent-browser select @e4 "valeur"Choisit une option de liste déroulante.
agent-browser upload @e5 fichier.pdfEnvoie un fichier.
agent-browser find role button click --name "Submit"Trouve un élément par son rôle, son texte ou son label, puis agit. Plus robuste qu’un sélecteur CSS.
agent-browser wait --text "Bienvenue"Attend un texte, un élément (wait "#id"), une URL (--url) ou un état de chargement (--load).

Capturer et déboguer

CommandeCe qu’elle fait
agent-browser screenshot page.pngCapture d’écran (--full pour la page entière).
agent-browser screenshot --if-changedNe renvoie l’image que si elle a changé. Recommandé pour économiser des tokens.
agent-browser screenshot --annotateCapture avec les éléments numérotés.
agent-browser console / errorsMessages console et erreurs JavaScript.
agent-browser network requests --filter apiRequêtes réseau suivies, filtrables.
agent-browser diff snapshotCompare avec le snapshot précédent.
agent-browser a11yAudit d’accessibilité (axe-core embarqué).
agent-browser vitalsWeb Vitals (LCP, CLS, INP…).

Enchaîner et gérer

CommandeCe qu’elle fait
agent-browser batch "open https://…" "snapshot -i" "screenshot"Plusieurs commandes en un seul appel : moins de démarrages de process.
agent-browser --session agent1 open …Sessions isolées (cookies, onglets, historique séparés).
agent-browser --profile Default open …Réutilise les connexions d’un profil Chrome existant.
agent-browser state save auth.json / state load auth.jsonSauvegarde et recharge un état connecté.
agent-browser closeFerme le navigateur (--all pour toutes les sessions).
agent-browser doctorDiagnostique l’installation.
agent-browser mcpDémarre le serveur MCP (profil d’outils core par défaut).

Sécurité

OptionEffet
--allowed-domains "example.com,*.example.com"Limite la navigation à ces domaines.
--content-boundariesEncadre le contenu des pages pour que le modèle le distingue des instructions.
--max-output 50000Plafonne la taille des réponses.
--confirm-actions eval,downloadDemande confirmation avant les actions sensibles.
agent-browser auth save <nom> / auth login <nom>Coffre-fort d’identifiants chiffré : le modèle ne voit jamais le mot de passe.

Conseils d’utilisation

  • Utiliser les références (@e1) plutôt que des sélecteurs CSS : elles viennent du snapshot et sont plus fiables.
  • Toujours refaire un snapshot après une navigation : les références d’un ancien snapshot ne sont plus valides.
  • Économiser le contexte : snapshot -i -c, screenshot --if-changed et batch réduisent nettement les tokens consommés.
  • Clic qui échoue : souvent une bannière de cookies ou une modale devant l’élément. La fermer, puis refaire un snapshot.
  • Attendre un état précis (texte, URL, élément) plutôt que --load networkidle, qui peut ne jamais se terminer sur les pages temps réel.
  • Pour les sites sensibles, combiner --allowed-domains et le coffre-fort auth : les pages web peuvent contenir des injections de prompt.

Sources