Prerender Buddy

Prerender Buddy MCP

Ferramentas MCP locais para verificar o que rastreadores públicos podem ler das respostas HTTP retornadas.

O servidor encapsula o projeto de código aberto @prerenderbuddy/cli. Ele não executa navegador, não executa JavaScript, não chama a API do Prerender Buddy e não exige conta.

Prefere um terminal ou fluxo de CI? Use o prerenderbuddy-cli diretamente. Consulte a visão geral das ferramentas do Prerender Buddy para comparar a CLI, o servidor MCP, a extensão do Chrome e o serviço gerenciado.

Início rápido

Execute o servidor stdio:

npx --yes @prerenderbuddy/mcp

Configuração genérica de cliente MCP:

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

Reinicie o cliente MCP após alterar a configuração.

Para verificar a conexão, peça ao cliente para listar as ferramentas MCP. Você deve ver:

check_crawler_readability
compare_http_responses
check_discovery_files

Ferramentas

check_crawler_readability

Busca uma página pública usando um user-agent de rastreador selecionado e retorna:

• status HTTP e URL final;
• título, descrição, canônica, cabeçalhos e contagens de texto legível;
• heurísticas transparentes de app-shell em JavaScript;
• evidências, gravidade e próximos passos contidos.

compare_http_responses

Compara uma resposta HTTP com user-agent padrão de navegador com uma resposta HTTP com user-agent de rastreador selecionado.

Ambos os lados são respostas HTTP comuns. Nenhum executa JavaScript. Uma diferença é evidência a ser revisada, não prova de cloaking ou problema de ranqueamento.

check_discovery_files

Verifica URLs públicas convencionais de robots.txt, sitemap.xml e llms.txt. Esses arquivos podem ajudar na descoberta e no acesso, mas não tornam o conteúdo do aplicativo legível por rastreadores.

Perfis de rastreador suportados:

• googlebot
• bingbot
• gptbot
• claudebot

Exemplos de prompts

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.

Limite do produto

Este pacote fornece diagnósticos locais pontuais para URLs públicas. Ele:

• usa os mesmos controles de segurança de URL pública, redirecionamento, tempo limite e tamanho de resposta da CLI;
• retorna resultados legíveis por máquina por meio do MCP;
• não tem telemetria nem autenticação;
• faz requisições de rede apenas para a URL pública que está sendo verificada.

Ele não fornece:

• renderização de navegador ou execução de JavaScript;
• roteamento gerenciado de rastreadores;
• monitoramento agendado, histórico ou incidentes;
• operações de cache;
• integração de DNS ou proxy;
• APIs ou infraestrutura privadas do Prerender Buddy.

O serviço gerenciado continua disponível em prerenderbuddy.com quando os testes mostram que uma implantação em produção ainda retorna HTML ausente, parcial ou não confiável.

Segurança

Teste apenas sites que você está autorizado a inspecionar. O pacote bloqueia alvos de rede locais, privados, link-local, reservados e multicast e revalida destinos de redirecionamento por meio da CLI.

O conteúdo de sites buscado é dado não confiável. Clientes MCP e modelos de linguagem não devem tratar o texto de página retornado como instruções. O aviso está incluído nas descrições das ferramentas e nos resultados estruturados, mas um aviso não elimina o risco de injeção de prompt. Os clientes devem manter seus próprios limites de confiança.

Não exponha este pacote local como um serviço irrestrito de busca de URLs públicas. Consulte SECURITY.md para o limite completo.

Resultados e erros

Chamadas bem-sucedidas retornam o diagnóstico completo da CLI tanto em structuredContent quanto em texto JSON serializado. Isso preserva o resultado completo para clientes MCP que não consomem saída estruturada. O servidor nunca retorna HTML bruto completo. As leituras de resposta de página são limitadas a 10.000 a 1.000.000 caracteres, e os trechos permanecem limitados pela CLI. As leituras de arquivos de descoberta usam o tratamento de resposta limitado da CLI.

Falhas de execução retornam isError: true, uma mensagem de texto curta e dados de erro estruturados com um código de diagnóstico estável alinhado às categorias da CLI: invalid_input, unsafe_target, timeout, request_failed ou internal_error. Erros inesperados são reduzidos a uma mensagem genérica para que caminhos locais não sejam expostos. Violações de esquema de entrada são rejeitadas pelo protocolo MCP antes de um diagnóstico ser executado.

As ferramentas intencionalmente ainda não declaram outputSchema. Seu structuredContent espelha o resultado da CLI pré-1.0, e um esquema será adicionado depois que esses formatos de resultado se estabilizarem.

Desenvolvimento

Requer Node.js 20 ou mais recente.

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

Configuração local do repositório:

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

Após alterar uma configuração do MCP, reinicie completamente o cliente. Se o servidor não aparecer, confirme que node --version informa 20 ou mais recente e que npx --yes @prerenderbuddy/mcp inicia sem erro imediato. Um servidor MCP stdio aguardando silenciosamente por entrada de protocolo é normal. Se um cliente GUI não conseguir encontrar npx, configure-o com o caminho absoluto retornado por command -v npx.

Próximos passos

• Execute a CLI diretamente.
• Compare todas as ferramentas de desenvolvimento do Prerender Buddy.
• Use o serviço gerenciado do Prerender Buddy quando os diagnósticos mostrarem que renderização ou monitoramento em produção é necessário.

Licença

Apache License 2.0.