Prerender Buddy

Prerender Buddy MCP

Herramientas MCP locales para comprobar qué pueden leer los rastreadores públicos de las respuestas HTTP devueltas.

El servidor envuelve el @prerenderbuddy/cli de código abierto. No ejecuta un navegador, no ejecuta JavaScript, no llama a la API de Prerender Buddy ni requiere una cuenta.

¿Prefieres un flujo de trabajo de terminal o CI? Usa la prerenderbuddy-cli directamente. Consulta la descripción general de las herramientas de Prerender Buddy para comparar la CLI, el servidor MCP, la extensión de Chrome y el servicio gestionado.

Inicio rápido

Ejecuta el servidor stdio:

npx --yes @prerenderbuddy/mcp

Configuración genérica del cliente MCP:

{
  "mcpServers": {
    "prerenderbuddy": {
      "command": "npx",
      "args": ["--yes", "@prerenderbuddy/mcp"]
    }
  }
}

Reinicia el cliente MCP después de cambiar su configuración.

Para verificar la conexión, pide al cliente que liste sus herramientas MCP. Deberías ver:

check_crawler_readability
compare_http_responses
check_discovery_files

Herramientas

check_crawler_readability

Obtiene una página pública usando un user-agent de rastreador seleccionado y devuelve:

• estado HTTP y URL final;
• título, descripción, canónica, encabezados y recuentos de texto legible;
• heurísticas transparentes de app-shell de JavaScript;
• evidencia, gravedad y próximos pasos prudentes.

compare_http_responses

Compara una respuesta HTTP estándar con user-agent de navegador con una respuesta HTTP con user-agent de rastreador seleccionado.

Ambos lados son respuestas HTTP ordinarias. Ninguno ejecuta JavaScript. Una diferencia es evidencia para revisar, no prueba de cloaking ni de un problema de posicionamiento.

check_discovery_files

Comprueba URLs públicas convencionales robots.txt, sitemap.xml y llms.txt. Estos archivos pueden ayudar al descubrimiento y al acceso, pero no hacen que el contenido de la aplicación sea legible para los rastreadores.

Perfiles de rastreador compatibles:

• googlebot
• bingbot
• gptbot
• claudebot

Ejemplos de indicaciones

Check whether Googlebot receives meaningful HTML from https://example.com.
Compare the standard and GPTBot HTTP responses for https://example.com/pricing.
Check the discovery files for https://example.com.

Límite del producto

Este paquete proporciona diagnósticos locales puntuales para URLs públicas. Permite:

• usar los mismos controles de seguridad de URL pública, redirecciones, tiempo de espera y tamaño de respuesta que la CLI;
• devolver resultados legibles por máquina a través de MCP;
• no tener telemetría ni autenticación;
• hacer solicitudes de red solo a la URL pública que se está comprobando.

No proporciona:

• renderizado de navegador ni ejecución de JavaScript;
• enrutamiento de rastreador gestionado;
• monitoreo programado, historial ni incidentes;
• operaciones de caché;
• incorporación de DNS o proxy;
• APIs o infraestructura privadas de Prerender Buddy.

El servicio gestionado sigue disponible en prerenderbuddy.com cuando las pruebas muestran que un despliegue de producción aún devuelve HTML faltante, parcial o poco fiable.

Seguridad

Prueba únicamente sitios web que estés autorizado a inspeccionar. El paquete bloquea destinos de red locales, privados, link-local, reservados y multicast, y revalida los destinos de redirección a través de la CLI.

El contenido de sitios web obtenido son datos no confiables. Los clientes MCP y los modelos de lenguaje no deben tratar el texto de la página devuelto como instrucciones. La advertencia se incluye en las descripciones de herramientas y en los resultados estructurados, pero una advertencia no elimina el riesgo de inyección de indicaciones. Los clientes deben mantener sus propios límites de confianza.

No expongas este paquete local como un servicio público de obtención de URLs sin restricciones. Consulta SECURITY.md para conocer el límite completo.

Resultados y errores

Las llamadas exitosas devuelven el diagnóstico completo de la CLI tanto en structuredContent como en texto JSON serializado. Esto conserva el resultado completo para los clientes MCP que no consumen salida estructurada. El servidor nunca devuelve HTML crudo completo. Las lecturas de respuestas de página se limitan a 10 000–1 000 000 de caracteres, y los extractos permanecen acotados por la CLI. Las lecturas de archivos de descubrimiento usan el manejo de respuestas acotado de la CLI.

Los fallos de ejecución devuelven isError: true, un mensaje de texto breve y datos de error estructurados con un código de diagnóstico estable alineado con las categorías de la CLI: invalid_input, unsafe_target, timeout, request_failed o internal_error. Los errores inesperados se reducen a un mensaje genérico para que no se expongan rutas locales. Las violaciones del esquema de entrada son rechazadas por el protocolo MCP antes de que se ejecute un diagnóstico.

Las herramientas deliberadamente aún no declaran outputSchema. Su structuredContent refleja el resultado de la CLI anterior a 1.0, y se añadirá un esquema después de que esas formas de resultado se estabilicen.

Desarrollo

Requiere Node.js 20 o superior.

npm ci --ignore-scripts
npm test
npm run test:coverage
npm run check
npm run pack:check

Configuración del repositorio local:

{
  "mcpServers": {
    "prerenderbuddy-local": {
      "command": "node",
      "args": ["/absolute/path/to/prerenderbuddy-mcp/bin/prerenderbuddy-mcp.js"]
    }
  }
}

Después de cambiar una configuración de MCP, reinicia el cliente por completo. Si el servidor no aparece, confirma que node --version informa 20 o superior y que npx --yes @prerenderbuddy/mcp se inicia sin un error inmediato. Es normal que un servidor MCP stdio espere silenciosamente la entrada del protocolo. Si un cliente GUI no puede encontrar npx, configúralo con la ruta absoluta devuelta por command -v npx.

Próximos pasos

• Ejecuta la CLI directamente.
• Compara todas las herramientas de desarrollo de Prerender Buddy.
• Usa el servicio gestionado de Prerender Buddy cuando los diagnósticos muestren que se necesita renderizado o monitoreo de producción.

Licencia

Apache License 2.0.