pagesnap-mcp

Servidor MCP que envuelve paquetes de sesiones PageSnap existentes para que un LLM pueda listar sesiones, leer localizadores y mapearlos a Playwright, Selenium o Cypress.

Esto NO es una herramienta de captura. No abre un navegador, no escanea URLs automáticamente ni descarga navegadores. Playwright no es una dependencia.

La captura ocurre en pagesnap-playwright o pagesnap-selenium. Apunta este servidor a un directorio principal de paquetes de sesión (flow.md más yaml y opcionalmente PROMPT.md).

Cómo ejecutarlo

npm install
npm run build
node dist/index.js

El proceso se comunica mediante MCP a través de stdio y queda a la espera en stdin. Parece colgado en una terminal; es lo esperado. Detenlo con Ctrl+C. Env opcional: PAGESNAP_SESSIONS_DIR (por defecto ./sessions) es el directorio principal de las carpetas de sesiones de PageSnap.

Related MCP server: Playwright MCP

Configuración MCP de Cursor

Ejemplo de .cursor/mcp.json. Apunta PAGESNAP_SESSIONS_DIR a un directorio principal de sesiones de PageSnap, p. ej. playwright-ts-framework/snapshots:

{
  "mcpServers": {
    "pagesnap": {
      "command": "node",
      "args": [
        "/absolute/path/to/pagesnap-mcp/dist/index.js"
      ],
      "env": {
        "PAGESNAP_SESSIONS_DIR": "/absolute/path/to/playwright-ts-framework/snapshots"
      }
    }
  }
}

Este servidor solo lee paquetes que ya están en el disco. No es una herramienta de captura.

Herramientas

Eficiencia de tokens: list_sessions y read_session devuelven la clave del primer nivel y resúmenes. No se vuelcan los cuerpos de los archivos YAML.

• list_sessions: sin argumentos. Sesiones de PAGESNAP_SESSIONS_DIR.

• read_session: { session }. lectura de flow.md, nombres de archivos yaml, controles analizados (máximo 200).

• map_locator: { by, value, name?, framework? }. fragmento, puntuación, estabilidad. framework: playwright|selenium|cypress (por defecto playwright).

• get_prompt: { session, framework? }. PROMPT.md si existe; de lo contrario, un prompt sintetizado.

Localizadores

Valores de by en YAML: testid, role, label, id, name, placeholder, linkText, css, xpath.

Scores según PageSnap: testid 98, role 95, label/id 90, name 88, placeholder 85, linkText 75, css 60, xpath 40.

Playwright testid siempre se asigna a page.getByTestId(...). Sauce Demo usa data-test a través de la propied Attribute de Playwright; sigue emitiendo getByTestId. Los nodos genéricos sin rol data-testid se siguen mapeando a getByTestId, nunca a getByRole('generic').

Tests

npx vitest run

Licencia

MIT