# OpenClaw: adicione um leitor de páginas web via MCP, ao lado do web_fetch

> Adicione um leitor de páginas web ao OpenClaw via MCP: openclaw mcp add, doctor --probe, e como o read_url complementa o web_fetch nativo. Pague com cripto.

- URL: https://webreaderapi.com/pt/docs/openclaw/
- Última atualização: 2026-10-22
- Editor: WebReaderAPI (https://webreaderapi.com)

O OpenClaw já tem uma ferramenta `web_fetch` para páginas leves. Adicionar nosso servidor MCP dá ao agente um segundo leitor, `read_url`, para páginas JavaScript, PDFs e documentos mais longos. A configuração é um comando só.

**Resposta rápida — Como adiciono uma API de leitura de páginas web ao OpenClaw?**

Salve o servidor MCP **WebReaderAPI**, depois registre-o com `openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=…` e verifique com `openclaw mcp doctor --probe`. O agente ganha uma ferramenta `read_url` ao lado do `web_fetch` nativo, capaz de renderizar JavaScript e ler PDFs. As páginas custam 1 crédito, a partir de US$ 0,07/1K páginas em outubro de 2026. Sem KYC; pague com cripto.

## web_fetch e read_url do OpenClaw lado a lado

| Atributo | Valor |
| --- | --- |
| web_fetch (nativo) | Roda localmente, extrai o conteúdo principal com Readability, retorna Markdown ou texto |
| limites do web_fetch | Sem execução de JavaScript; `maxChars` padrão e limite de 20.000 caracteres (docs do OpenClaw) |
| read_url (nossa ferramenta MCP) | Renderização de JavaScript quando necessário, PDFs de até 100 páginas, até 500.000 caracteres |
| custo do read_url | 1 crédito = 1 página lida sem navegador; 2 créditos quando a página precisa de um navegador para renderizar JavaScript. Uma requisição que falha, ou que o robots.txt de um site recusa, não é cobrada |
| Nosso rastreador (crawler) | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt respeitado |
| Perfis de ferramentas | As ferramentas MCP aparecem nos perfis `coding` e `messaging`, não em `minimal` |

## Por que adicionar um leitor se o OpenClaw tem web_fetch?

Porque eles cobrem páginas diferentes. A documentação do OpenClaw diz que `web_fetch` sempre roda localmente, usa Readability para extrair o conteúdo principal e não executa JavaScript; ela indica a ferramenta Web Browser para sites com muito JavaScript ou protegidos por login. A configuração `maxChars` tem padrão de 20.000 caracteres e é limitada a isso.

Mantenha `web_fetch` para páginas rápidas e leves. Adicione `read_url` para páginas que montam o conteúdo com JavaScript, para PDFs e para documentos longos em que você quer mais de 20.000 caracteres. A documentação do OpenClaw também observa que o plugin oficial do Firecrawl é hoje o único provedor incluído para o qual `web_fetch` pode recorrer.

## Como registro o servidor MCP no OpenClaw?

Primeiro configure o servidor Python a partir da [página MCP](https://webreaderapi.com/pt/docs/mcp/): um arquivo mais os pacotes `mcp` e `httpx`. Depois salve-o no OpenClaw com `openclaw mcp add`. A documentação do registro do OpenClaw descreve as flags stdio `--command`, `--arg`, `--env` e `--cwd`, e armazena as definições salvas em `mcp.servers` na configuração.

Execute `openclaw mcp doctor --probe` depois. Sem `--probe`, o doctor só verifica a configuração salva; com ele, também confirma que os servidores habilitados se conectam.

*Registrar e verificar o servidor*

```bash
openclaw mcp add webreaderapi \
  --command /home/you/webreader/.venv/bin/python \
  --arg /home/you/webreader/webreader_mcp.py \
  --env WEBREADER_API_KEY=your-key

openclaw mcp doctor webreaderapi --probe
```

## O agente vai ver read_url?

Nos perfis usuais, sim. A documentação do registro do OpenClaw diz que o OpenClaw embutido expõe as ferramentas MCP configuradas nos perfis `coding` e `messaging`. O perfil `minimal` as oculta, e `tools.deny: ["bundle-mcp"]` as desativa, então verifique essas duas configurações se a ferramenta não aparecer.

A descrição da ferramenta diz ao modelo quando preferi-la: páginas que precisam de JavaScript, PDFs e leituras longas. O modelo ainda pode usar `web_fetch` para todo o resto.

## Como o read_url trata os sites que lê?

Da mesma forma que toda chamada à nossa API. Respeitamos o robots.txt: nosso crawler se identifica como WebReaderAPI, segue as regras escritas para ele ou para todos os robôs e não lê uma página que o site proíbe. Páginas recusadas não são cobradas. Se um site declara Content-Signal: ai-input=no no seu robots.txt, não lemos as páginas dele para você. Se um site recusa nossa requisição, devolvemos a resposta dele: nunca resolvemos CAPTCHAs, nunca entramos em contas e nunca tentamos contornar um bloqueio ou um paywall.

Páginas atrás de login ficam, portanto, fora do escopo do `read_url`. Para um site em que você está conectado, a própria ferramenta de navegador do OpenClaw, rodando com sua sessão, é a ferramenta certa.

## Quanto vai custar ler páginas pelo OpenClaw?

Um crédito por página que volta com conteúdo, dois quando é preciso um navegador, nada para recusas e erros. Um assistente que lê 30 páginas por dia nos seus canais de chat usa cerca de 900 créditos por mês: 10.000 páginas (US$ 3,75) dura quase um ano. Os créditos pré-pagos nunca expiram: as páginas não usadas ficam na sua conta até você usá-las.

Dê ao OpenClaw uma chave de API própria, para que o uso dele apareça separado dos seus outros projetos.

## OpenClaw: perguntas frequentes

### O WebReaderAPI é um provedor nativo do OpenClaw?

Não. Ele se conecta como servidor MCP, que o OpenClaw suporta sem nenhum código de plugin. O servidor MCP é o arquivo Python curto da nossa [página MCP](https://webreaderapi.com/pt/docs/mcp/).

### Devo desativar o web_fetch?

Não precisa. As duas ferramentas podem ficar ativas; as descrições dizem ao modelo qual delas serve. Desative `web_fetch` só se quiser que toda leitura passe por um único lugar para registro.

### Posso gerenciar o servidor pela interface web do OpenClaw?

A documentação do OpenClaw descreve as configurações de MCP na Control UI, que editam as mesmas definições salvas da linha de comando. Use a que preferir.

### Funciona em uma instalação do OpenClaw em sandbox?

O servidor MCP é um processo local que precisa de acesso à internet para chegar a `https://webreaderapi.com/api/v1/read`. Verifique se o seu sandbox permite que o processo inicie e faça essa chamada HTTPS.

## Fontes

1. [Ferramentas web](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [Web Fetch](https://docs.openclaw.ai/tools/web-fetch) — OpenClaw docs (read 2026-10-22)
3. [Gerenciar servidores MCP salvos](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)
4. [MCP na Control UI](https://docs.openclaw.ai/cli/mcp/control-ui) — OpenClaw docs (read 2026-10-22)

---

WebReaderAPI: O WebReaderAPI é uma API de leitor web para agentes de IA que converte qualquer página web pública em Markdown limpo, pago com cripto e sem envio de documentos. Os créditos pré-pagos a partir de US$ 0,07/1K páginas nunca expiram, e o robots.txt é respeitado. Sem KYC — sem documento, sem selfie, sem envio de arquivos. Pague com cripto.
