Render-fetch

Atualização direta para o WebFetch do Claude que detecta automaticamente páginas renderizadas com JS e as busca com o navegador headless Playwright

GitHub

Documentação

render-fetch

Upgrade direto para o WebFetch do Claude Code — lida com páginas renderizadas por JS automaticamente.

O WebFetch integrado do Claude não executa JavaScript. SPAs modernas retornam esqueletos vazios. O render-fetch detecta automaticamente se uma página precisa de um navegador real e roteia de acordo — sem necessidade de configuração.

Instalação

Adicione às configurações do seu Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "render-fetch": {
      "command": "npx",
      "args": ["-y", "render-fetch"]
    }
  }
}

A primeira execução instala o Chromium (~150MB, uma única vez). Execuções subsequentes são instantâneas.

Como funciona

URL in
  │
  ├─ GET page (fast, reuses response)
  │
  ├─ Score for JS-rendering signals
  │     <div id="root/app/__next">  +3
  │     thin body (<500 chars)      +2
  │     data-reactroot / ng-version +2
  │     window.__REDUX_STATE__      +2
  │     bundled JS patterns         +1
  │     .md / docs domain           -3
  │
  ├─ Score < 3 → Static path
  │     HTTP → cheerio → Readability → markdown
  │
  └─ Score ≥ 3 → Browser path
        Playwright headless → networkidle → Readability → markdown

Ferramentas

Ferramenta	O que faz	Parâmetros principais	Retorna
`fetch`	Busca a página como markdown (detecta o modo automaticamente)	`url`, `mode` (auto/static/browser), `maxLength` (padrão 50k), `timeout` (padrão 30s)	Markdown limpo
`fetch_raw`	Busca a página como HTML bruto	`url`, `mode`, `timeout`	String de HTML bruto
`screenshot`	Tira um screenshot da viewport	`url`, `fullPage` (padrão false), `timeout`	PNG em Base64 (máx. 2MB)

Por que nem sempre usar o navegador? O caminho estático leva em média ~200ms. O caminho do navegador leva em média 2–3s, além da sobrecarga de inicialização do Chromium na primeira solicitação.

Limitações conhecidas

DNS rebinding: a validação do hostname acontece antes da solicitação; um servidor malicioso poderia teoricamente redirecionar para um IP privado após a validação. Mitigação planejada para a v1.1.
Uso local apenas: não foi projetado para implantações de servidor multi-tenant. Para isso, coloque um proxy reverso com limite de taxa na frente.
Instalação do Chromium: download único de ~150MB na primeira solicitação em modo navegador.

Contribuindo

Veja CONTRIBUTING.md.