Configurer Playwright

Ce guide décrit les trois étapes d'installation qui donnent à career-ops ses capacités d'automatisation du navigateur :

Installer le package Playwright

Exécutez npm install depuis le dossier racine de career-ops :

npm install

Cette commande installe Playwright ainsi que toutes les autres dépendances du projet déclarées dans package.json. Passez cette étape si vous l'avez déjà exécutée lors de l'installation initiale.

Télécharger Chromium

Playwright a besoin de sa propre copie de Chromium pour l'automatisation. L'installeur la télécharge normalement de façon automatique juste après les dépendances ; si npm run doctor signale qu'elle est manquante, téléchargez-la en exécutant :

npx playwright install chromium

Cette étape ne s'effectue qu'une seule fois. Vous n'avez pas besoin de la répéter après les mises à jour npm.

npm install n'effectue pas le téléchargement automatique lorsque PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD est défini dans votre environnement avec une valeur autre que vide, 0 ou false ; dans ce cas, exécutez vous-même la commande ci-dessus. Sous NixOS, passez complètement cette étape : les navigateurs téléchargés ne peuvent pas y démarrer, et le dev shell du flake du dépôt fournit à la place des navigateurs fonctionnels ainsi que le serveur MCP Playwright, comme l'explique le guide NixOS du cœur de career-ops.

Configurer le MCP Playwright

Le MCP Playwright permet à Claude de contrôler directement le navigateur pendant l'étape /career-ops apply — naviguer vers les formulaires de candidature, lire les libellés des champs et suggérer des réponses.

Enregistrer le serveur MCP

Exécutez cette commande depuis le dossier racine de career-ops pour enregistrer le MCP Playwright auprès de Claude Code :

claude mcp add --scope project playwright -- npx @playwright/mcp@latest

C'est la méthode d'enregistrement en une seule étape décrite dans la documentation du MCP Playwright, avec --scope project en plus pour que Claude Code écrive l'entrée du serveur dans .mcp.json, à la racine de career-ops, l'un des fichiers que vérifie npm run doctor. Au prochain lancement de Claude Code dans ce dossier, approuvez le serveur lorsqu'il vous le demande.

Pour l'utiliser dans tous vos projets, exécutez la commande avec --scope user. npm run doctor le détecte là aussi : il lit les serveurs que Claude Code conserve pour votre utilisateur et pour ce projet, pas seulement .mcp.json.

Configuration manuelle (alternative)

Si vous préférez le configurer à la main, ajoutez l'entrée suivante à .mcp.json à la racine de career-ops (créez le fichier s'il n'existe pas) :

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Redémarrez Claude Code après avoir enregistré le fichier et approuvez le serveur lorsqu'il vous le demande. career-ops aura alors accès à browser_navigate et browser_snapshot pendant les sessions apply.

Vérifier l'installation

Exécutez le script doctor pour confirmer que les trois composants sont en place :

npm run doctor

Vérifiez que Playwright, Chromium et le serveur MCP sont tous signalés comme prêts. Si la vérification réussit, l'installation est terminée.

Regarder le navigateur remplir le formulaire

Par défaut, le MCP Playwright ouvre une fenêtre de navigateur visible (la configuration ci-dessus ne passe pas --headless) : vous voyez chaque page qu'il lit et chaque champ qu'il remplit.

Pour qu'il ouvre la candidature dans cette fenêtre et remplisse tout le formulaire, ajoutez une instruction à la commande apply :

/career-ops apply {company_name} open up with playwright the browser and fill out the entire form

Run the /career-ops apply command with the {company_name} argument. Then, use the Playwright MCP to open a browser window and fill out the entire form live.

Run the /career-ops apply command with the {company_name} argument. Then, use the Playwright MCP to open a browser window and fill out the entire form live.

Run the /career-ops apply command with the {company_name} argument. Then, use the Playwright MCP to open a browser window and fill out the entire form live.

Pour Ashby, Playwright peut inspecter le formulaire et aider à rédiger les réponses, mais terminez et envoyez la candidature dans votre navigateur habituel. Vérifiez la page de réussite ou l’e-mail de confirmation avant de la marquer comme envoyée.

Sans cette instruction, career-ops utilise quand même Playwright et le MCP pour lire le formulaire et rédiger vos réponses, dans la même fenêtre visible.

Ce que chaque composant apporte