Configura Playwright

Esta guía recorre los tres pasos de configuración que dan a career-ops sus capacidades de automatización del navegador:

Instala el paquete de Playwright

Ejecuta npm install desde la carpeta raíz de career-ops:

npm install

Esto instala Playwright y el resto de dependencias del proyecto declaradas en package.json. Sáltate este paso si ya lo ejecutaste durante la configuración inicial.

Descarga Chromium

Playwright necesita su propia copia de Chromium para automatizar. El instalador normalmente la descarga automáticamente justo después de las dependencias; si npm run doctor indica que falta, descárgala ejecutando:

npx playwright install chromium

Es un paso que se hace una sola vez. No necesitas repetirlo tras actualizaciones de npm.

npm install omite la descarga automática cuando PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD está definida en tu entorno con cualquier valor distinto de vacío, 0 o false; en ese caso, ejecuta tú el comando anterior. En NixOS, sáltalo por completo: los navegadores descargados no pueden arrancar allí, y la dev shell del flake del repositorio proporciona en su lugar navegadores que funcionan y el servidor MCP de Playwright, como explica la guía de NixOS del core.

Configura el MCP de Playwright

El MCP de Playwright permite a Claude controlar el navegador directamente durante el paso /career-ops apply — navegar hasta los formularios de solicitud de empleo, leer las etiquetas de los campos y sugerir respuestas.

Registra el servidor MCP

Ejecuta este comando desde la carpeta raíz de career-ops para registrar el MCP de Playwright en Claude Code:

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

Este es el método de registro en un solo paso de la documentación del MCP de Playwright, con --scope project añadido para que Claude Code escriba la entrada del servidor en .mcp.json, en la raíz de career-ops, uno de los archivos que revisa npm run doctor. La próxima vez que inicies Claude Code allí, aprueba el servidor cuando te lo pida.

Para usarlo en todos tus proyectos, ejecuta el comando con --scope user. npm run doctor también lo encuentra ahí: lee los servidores que Claude Code guarda para tu usuario y para este proyecto, no solo .mcp.json.

Configuración manual (alternativa)

Si prefieres configurarlo a mano, añade la siguiente entrada a .mcp.json en la raíz de career-ops (crea el archivo si no existe):

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

Reinicia Claude Code tras guardar el archivo y aprueba el servidor cuando te lo pida. career-ops tendrá entonces acceso a browser_navigate y browser_snapshot durante las sesiones de apply.

Verifica la configuración

Ejecuta el script doctor para confirmar que los tres componentes están en su sitio:

npm run doctor

Busca la confirmación de que Playwright, Chromium y el servidor MCP están listos. Si la comprobación pasa, la configuración está completa.

Mira cómo el navegador rellena el formulario

Por defecto, el MCP de Playwright abre una ventana visible del navegador (la configuración anterior no pasa --headless), así que puedes ver cada página que lee y cada campo que rellena.

Para que abra la solicitud en esa ventana y rellene el formulario completo, añade una instrucción al comando 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.

Para Ashby, Playwright puede inspeccionar el formulario y ayudar a redactar respuestas, pero termina y envía la candidatura en tu navegador habitual. Comprueba la página de éxito o el correo de confirmación antes de marcarla como enviada.

Sin esa instrucción, career-ops sigue usando Playwright y el MCP para leer el formulario y redactar tus respuestas, en la misma ventana visible.

Qué habilita cada componente