career-ops
Guías

Configura Playwright

Instala y configura Playwright para la automatización del navegador.

Updated

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 Node de Playwright

Descarga el navegador Chromium que Playwright controla

Configura el MCP de Playwright para que Claude pueda manejar el navegador durante el paso apply

Antes de empezar

Completa la guía de inicio rápido. Node.js 20 LTS o posterior debe estar instalado y debes estar dentro de la carpeta raíz de career-ops.


Instala el paquete de Playwright

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

Terminal
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:

Terminal
npx playwright install chromium

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

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 cualquier ubicación para registrar el MCP de Playwright en Claude Code:

Terminal
claude mcp add playwright npx @playwright/mcp@latest

Este es el método de registro en un solo paso de la documentación del MCP de Playwright. Escribe la entrada del servidor en tu configuración de Claude automáticamente.

Configuración manual (alternativa)

Si prefieres configurarlo a mano, añade la siguiente entrada a .claude/settings.local.json en la raíz de career-ops, o a tu configuración global de Claude:

.claude/settings.local.json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["y", "@playwright/mcp@latest"]
    }
  }
}

Reinicia Claude Code tras guardar el archivo. 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:

Terminal
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, Playwright se ejecuta en modo headless: lee y rellena el formulario en segundo plano sin abrir una ventana visible.

Para ver cómo el navegador se abre y rellena el formulario en directo, 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.

Sin esa instrucción, career-ops sigue usando Playwright y el MCP — simplemente opera en silencio en segundo plano.

Qué habilita cada componente

ComponentePropósito
Paquete de PlaywrightBiblioteca central que impulsa la automatización del navegador
ChromiumRenderiza páginas, genera PDFs con calidad de impresión mediante /career-ops pdf, comprueba si las ofertas de empleo siguen activas y da soporte a los escaneos completos de ATS
MCP de PlaywrightPermite a career-ops navegar por formularios y sugerir respuestas para los campos durante /career-ops apply

On this page