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.

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 n'importe quel emplacement pour enregistrer le MCP Playwright auprès de Claude Code :

claude mcp add playwright npx @playwright/mcp@latest

C'est la méthode d'enregistrement en une seule étape décrite dans la documentation du MCP Playwright. Elle ajoute automatiquement l'entrée du serveur à vos paramètres Claude.

Configuration manuelle (alternative)

Si vous préférez le configurer à la main, ajoutez l'entrée suivante à .claude/settings.local.json dans la racine de career-ops, ou à vos paramètres Claude globaux :

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

Redémarrez Claude Code après avoir enregistré le fichier. 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, Playwright s'exécute en mode headless — il lit et remplit le formulaire en arrière-plan sans ouvrir de fenêtre visible.

Pour voir le navigateur s'ouvrir et remplir le formulaire en direct, 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.

Sans cette instruction, career-ops utilise quand même Playwright et le MCP — il opère simplement en silence, en arrière-plan.

Ce que chaque composant apporte