Prerender Buddy

Herramientas MCP para diagnóstico de legibilidad de rastreadores y archivos de descubrimiento, incluyendo inspección de HTML visible para rastreadores, comparación entre versión cruda y renderizada, y verificaciones de archivos de descubrimiento.

GitHub

Prueba este MCPPatrocinado

Documentación

Prerender Buddy MCP

El compañero MCP de la plataforma Prerender Buddy de visibilidad de IA y preparación para rastreadores. Comprueba qué pueden leer los rastreadores públicos y puede recuperar opcionalmente evidencia de un espacio de trabajo de Prerender Buddy, con generación opcional de artículos confirmados.

El servidor envuelve el @prerenderbuddy/cli de código abierto. Las herramientas de auditoría pública no ejecutan un navegador, no ejecutan JavaScript, no llaman a la API de Prerender Buddy ni requieren una cuenta. Los usuarios Pro pueden configurar opcionalmente una clave de API para añadir herramientas de salud, actividad, visibilidad, recomendaciones y estado de contenido conscientes de la cuenta.

¿Prefieres un flujo de trabajo de terminal o CI? Usa el 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

Con PRERENDER_BUDDY_API_KEY configurado, el servidor también lista:

list_sites
get_site_overview
get_health_evidence
get_crawler_activity
get_ai_visibility
get_recommendations
get_content_status

Grok Build

Grok Build puede lanzar el servidor stdio local:

grok mcp add prerenderbuddy -- npx --yes @prerenderbuddy/mcp@0.3.0

O instala el plugin oficial, que ya incluye manifiestos compatibles con Claude:

grok plugin marketplace add kopachlager/prerenderbuddy-plugins
grok plugin install prerenderbuddy --trust

Establece PRERENDER_BUDDY_API_KEY en el entorno del proceso cuando se requiera evidencia del espacio de trabajo. Los marcadores de posición no resueltos como ${PRERENDER_BUDDY_API_KEY} se tratan como ausentes.

HTTP Streamable / Grok Bot

Grok Bot en grok.com, iOS y Android no puede iniciar un proceso npx local. Necesita una URL MCP HTTPS pública.

Ejecuta HTTP Streamable localmente:

npx --yes @prerenderbuddy/mcp@0.3.0 --http --port 8787

HTTP de bucle local (127.0.0.1) permite herramientas de diagnóstico públicas no autenticadas y aún limita las solicitudes. Vincular una interfaz pública (--host 0.0.0.0 o un HOST no de bucle local) requiere un token Bearer:

una clave de API de espacio de trabajo Pro válida y no revocada (pb_live_... o pb_test_...), verificada con la API de PB antes de cada solicitud autenticada, que también habilita las herramientas del espacio de trabajo; o
MCP_HTTP_SHARED_TOKEN, un token de conector solo para diagnósticos públicos.

MCP_TRANSPORT=http HOST=0.0.0.0 PORT=8787 MCP_HTTP_REQUIRE_AUTH=true \
  npx --yes @prerenderbuddy/mcp@0.3.0

Comprobación de salud: GET /health. Endpoint MCP: POST /mcp. GET y DELETE autenticados en /mcp devuelven 405; este endpoint JSON sin estado no ofrece una sesión de flujo SSE.

Implementa el Dockerfile como un servicio dedicado con MCP_TRANSPORT=http, HOST=0.0.0.0 y MCP_HTTP_REQUIRE_AUTH=true; conserva el PORT de la plataforma de alojamiento. railway.json configura la comprobación de salud. Nunca establezcas PRERENDER_BUDDY_API_KEY en un servicio HTTP compartido: las herramientas HTTP usan solo la clave del espacio de trabajo de la solicitud y nunca heredan la clave del proceso.

El límite de entrada predeterminado es de 120 solicitudes MCP por minuto por proceso, incluida la autenticación fallida. MCP_HTTP_INGRESS_RATE_LIMIT_MAX controla este límite. Las credenciales autenticadas además tienen un límite predeterminado de 30 solicitudes por minuto (MCP_HTTP_RATE_LIMIT_MAX). No se confía en las cabeceras de IP reenviadas. El almacenamiento del límite de velocidad es acotado; estos límites son locales al proceso, así que usa un límite de puerta de enlace compartido antes de escalar a múltiples réplicas. Los fallos de verificación de API rechazan el acceso; las claves revocadas no se almacenan en caché.

Para Grok Bot, expón esa URL a través de HTTPS, luego:

Abre grok.com/connectors.
Nuevo Conector → Personalizado.
Introduce https://your-host/mcp.
Prerender Buddy alojado usa OAuth Authorization Code con PKCE S256 obligatorio. Las implementaciones autoalojadas pueden configurar alternativamente un token Bearer.

Los túneles temporales funcionan para demos; Grok rechaza localhost. Prefiere respuestas JSON HTTP Streamable, que este servidor habilita por defecto. Los túneles rápidos de Cloudflare no soportan SSE.

No publiques un endpoint abierto y no autenticado de recuperación de URL. El uso alojado necesita HTTPS, límites de velocidad y un token.

Modo de espacio de trabajo opcional

Crea una clave de API Pro en Prerender Buddy y concede solo los grupos de evidencia que el agente necesite. Mantén la clave en el entorno del proceso MCP, nunca en un prompt o archivo del repositorio.

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

El origen de API predeterminado es https://api.prerenderbuddy.com. Las implementaciones autoalojadas o de desarrollo en staging pueden sobrescribirlo con PRERENDER_BUDDY_API_BASE_URL.

Las herramientas del espacio de trabajo requieren autenticación y están limitadas por la API a sitios registrados dentro de la asignación del plan. Las herramientas de evidencia existentes permanecen de solo lectura y devuelven resúmenes acotados. La generación de artículos es un permiso de opt-in separado; su respuesta de tarea incluye el cuerpo del borrador guardado. Las respuestas completas del proveedor no se devuelven.

Herramientas

`check_crawler_readability`

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

estado HTTP y URL final;
título, descripción, canónico, encabezados y recuentos de texto legible;
heurísticas transparentes de shell de aplicación JavaScript;
evidencia, severidad y próximos pasos moderados.

`compare_http_responses`

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

Ambos lados son respuestas HTTP ordinarias. Ninguno ejecuta JavaScript. Una diferencia es evidencia a revisar, no prueba de cloaking o un problema de ranking.

`check_discovery_files`

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

Perfiles de rastreador soportados:

googlebot
bingbot
gptbot
claudebot

Herramientas de evidencia del espacio de trabajo

list_sites: lista los sitios e IDs del espacio de trabajo registrados.
get_site_overview: resume configuración, monitoreo, actividad y visibilidad.
get_health_evidence: devuelve incidentes de salud, evidencia de archivos de descubrimiento, alcanzabilidad y borradores de revisión propuestos acotados.
get_crawler_activity: agrupa visitas reales de rastreadores por plataforma y página.
get_ai_visibility: resume plataformas, dominios citados y competidores.
get_recommendations: devuelve el diagnóstico más reciente basado en evidencia.
get_content_status: lista metadatos de calendario y borradores sin cuerpos de artículos.

Prompts de ejemplo

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.
List my Prerender Buddy sites, then summarize health and AI visibility for the selected site.

Límite del producto

En modo stdio local sin clave de API, este paquete proporciona diagnósticos locales únicos para URLs públicas. Este:

usa los mismos controles públicos de seguridad de URL, redirección, tiempo de espera y tamaño de respuesta que la CLI;
devuelve resultados legibles por máquina a través de MCP;
no tiene telemetría ni autenticación;
hace solicitudes de red solo a la URL pública que se está comprobando.

El modo de auditoría pública no proporciona:

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

El modo de espacio de trabajo opcional llama solo a la API de desarrollador autenticada documentada. No se conecta directamente a bases de datos, colas, internos de facturación, credenciales de proveedor o el motor de renderizado. El paquete MCP no almacena ni transmite la clave de API en ningún lugar excepto la cabecera Authorization enviada al origen de API de Prerender Buddy configurado.

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

Seguridad

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

El contenido del sitio web recuperado 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 resultados estructurados, pero una advertencia no elimina el riesgo de inyección de prompts. Los clientes deben mantener sus propios límites de confianza.

La evidencia del proveedor del espacio de trabajo y los títulos o recomendaciones guardados también son datos no confiables. Usa claves de API con los alcances más pequeños requeridos y revoca una clave desde el panel de Prerender Buddy si se expone.

No expongas este paquete local como un servicio público sin restricciones de recuperación de URL. Consulta SECURITY.md para 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 preserva el resultado completo para clientes MCP que no consumen salida estructurada. El servidor nunca devuelve HTML crudo completo. Las lecturas de respuesta de página están limitadas a 10,000–1,000,000 caracteres, y los extractos permanecen acotados por la CLI. Las lecturas de archivos de descubrimiento usan el manejo de respuesta acotado de la CLI.

Los fallos de ejecución devuelven isError: true, un mensaje de texto corto 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.

Los fallos de API del espacio de trabajo preservan información acotada de estado, código de error e ID de solicitud sin devolver credenciales, cabeceras de respuesta o trazas de pila internas. Las respuestas están limitadas localmente a 2 MB además de los límites de salida del lado de la API.

Las herramientas intencionalmente no declaran outputSchema todavía. Su structuredContent refleja el resultado de la CLI pre-1.0, y se añadirá un esquema después de que esas formas de resultado se estabilicen.

Desarrollo

Requiere Node.js 20 o más reciente.

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 MCP, reinicia completamente el cliente. Si el servidor no aparece, confirma que node --version reporta 20 o más reciente y que npx --yes @prerenderbuddy/mcp se inicia sin un error inmediato. Un servidor MCP stdio esperando silenciosamente entrada de protocolo es normal. 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 desarrollador 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

Licencia Apache 2.0.

Propuestas y generación de artículos (0.3.0)

Hay 14 herramientas: tres diagnósticos públicos, siete lecturas de evidencia del espacio de trabajo y cuatro herramientas de flujo de trabajo de artículos. El acceso a la API de desarrollador requiere un espacio de trabajo Pro elegible. Listar ideas y recuperar tareas requieren content. Preparar y generar también requieren content:write. Las claves existentes y los permisos OAuth permanecen de solo lectura; crea una clave con alcance o reconéctate solicitando el permiso adicional.

list_article_ideas(siteId) lista preguntas rastreadas con respuestas registradas exitosas y la asignación de borradores restante del espacio de trabajo.
prepare_article_proposal(siteId, promptId, requestId, sourceJobId?, note?) pone en cola una propuesta con fuentes. Genera un requestId UUID una vez y reutilízalo al reintentar la misma solicitud. Usa un nuevo UUID para un brief cambiado.
Consulta get_article_task(siteId, taskId) en el intervalo devuelto. Muestra la propuesta lista y la asignación actual al usuario. Las propuestas expiran después de 24 horas.
Solo después de la confirmación explícita del usuario, llama a generate_article(siteId, taskId, confirmGeneration: true). Esto reserva un borrador de la misma asignación del espacio de trabajo usada por la aplicación.
Consulta la tarea hasta que se complete. Devuelve el borrador Markdown guardado y un enlace de revisión de PB. El borrador permanece sin aprobar; estas herramientas no pueden publicarlo.

La preparación no consume una asignación de borradores. Para acotar los costos de preparación, los espacios de trabajo pueden iniciar 12 propuestas por hora y tener dos tareas activas. La generación fallida o interrumpida libera su reserva. Reintentar una tarea confirmada no crea ni cobra otro borrador. El texto fuente es evidencia, nunca consentimiento. La API y el trabajador de visibilidad deben actualizarse antes de usar estas herramientas.