# OpenClaw: adicionar busca na web com o texto da página via MCP

> Adicione o LLMWebSearch ao OpenClaw via MCP: openclaw mcp add, doctor --probe e como o search_web convive com os 16 provedores web_search integrados. Sem KYC.

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

O OpenClaw já escolhe um provedor `web_search` da própria lista. Registrar nosso servidor MCP adiciona uma segunda ferramenta de pesquisa, `search_web`, cujos resultados vêm com as principais páginas já lidas, além de `read_urls` para links que o agente já tem.

**Resposta rápida — Como adiciono uma API de busca na web com conteúdo de página ao OpenClaw?**

Salve o servidor MCP **LLMWebSearch** da nossa página de MCP, registre-o com `openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=…` e depois verifique com `openclaw mcp doctor --probe`. O agente ganha o `search_web`, cujos resultados incluem as 3 principais páginas em Markdown, ao lado do `web_search` integrado do OpenClaw. Uma pesquisa custa 1 crédito, a partir de US$ 1,20/1K pesquisas em outubro de 2026. Sem KYC.

## Busca no OpenClaw, conforme documentado em 22 de outubro de 2026

| Atributo | Valor |
| --- | --- |
| Provedores web_search integrados | 16, incluindo Brave Search, DeepSeek, DuckDuckGo, Exa, Firecrawl, Gemini, Parallel, Perplexity, SearXNG e Tavily |
| Escolha automática | O primeiro provedor com API pronto, em uma ordem fixa que começa com o Brave |
| Provedores sem chave | Nunca escolhidos automaticamente; você mesmo os seleciona |
| Nossas ferramentas (MCP) | `search_web` e `read_urls`, a partir de um servidor Python local |
| Nosso custo | Um crédito paga uma pesquisa: até 20 resultados classificados, com as páginas dos 3 primeiros lidas e devolvidas em Markdown. Ler de 4 a 10 páginas custa 2 créditos. Uma chamada que termina em erro não custa nada |
| Nosso leitor de páginas | `LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)`, robots.txt respeitado |

## Por que adicionar nossa pesquisa se o OpenClaw tem web_search?

Para obter o texto da página junto com os resultados em uma só chamada. A página de ferramentas web do OpenClaw lista 16 provedores integrados para `web_search`, escolhidos em uma ordem fixa de detecção automática quando nenhum está definido. Nossa ferramenta não substitui essa escolha; ela adiciona uma segunda opção que o modelo pode chamar de propósito.

`search_web` retorna fontes numeradas com as primeiras páginas já lidas em Markdown, para que o agente possa responder e citar sem uma busca separada para cada link. `read_urls` lê até 20 links que o agente encontrou em outro lugar, pelo mesmo leitor.

## Como registro o servidor MCP?

Primeiro configure o servidor Python da [página de MCP](https://llmwebsearch.com/pt/docs/mcp/): um arquivo, mais os pacotes `mcp` e `httpx` em um ambiente virtual. 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 pede que o Gateway local seja parado enquanto os servidores salvos mudam.

Execute `openclaw mcp doctor --probe` em seguida. Sem `--probe` o doctor só verifica as configurações salvas; com ele, também comprova que o servidor se conecta.

*Registrar e verificar o servidor*

```bash
openclaw mcp add llmwebsearch \
  --command /home/you/llmwebsearch/.venv/bin/python \
  --arg /home/you/llmwebsearch/llmwebsearch_mcp.py \
  --env LLMWEBSEARCH_API_KEY=your-key

openclaw mcp doctor llmwebsearch --probe
```

## O agente vai ver o search_web?

Nos perfis habituais, sim. A documentação do registro do OpenClaw diz que as ferramentas MCP configuradas aparecem nos perfis de ferramentas `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 estiver faltando.

A docstring da ferramenta informa ao modelo o que ela retorna. Adicione uma linha às instruções do seu agente se quiser que ela seja preferida, por exemplo "use search_web quando precisar citar uma página".

## O LLMWebSearch pode ser selecionado como provedor de web_search?

Hoje não. A documentação do OpenClaw diz que a configuração de provedor aceita os provedores declarados pelos manifests de plugins incluídos e instalados. Não publicamos nenhum plugin do OpenClaw, então nossa pesquisa chega como ferramentas MCP com nomes próprios.

Na prática, isso muda pouco para o agente: ele chama `search_web` da mesma forma que chamaria `web_search`. Também mantém os dois fáceis de distinguir nos logs do OpenClaw e no seu histórico de uso.

## Como o nosso leitor trata os sites nos resultados?

Como faz em toda chamada. Nosso leitor respeita o robots.txt: ele se identifica como LLMWebSearch, segue as regras que um site escreve para ele ou para todos os robôs e deixa de fora o conteúdo de qualquer página que não tem permissão para ler. Um site que define Content-Signal: ai-input=no no seu robots.txt mantém as suas páginas fora do conteúdo dos seus resultados. Quando um site recusa o nosso leitor, o resultado volta sem conteúdo e com o status do site: nunca resolvemos CAPTCHAs, não entramos em contas nem contornamos um bloqueio ou um paywall.

Uma página atrás de login, portanto, volta sem conteúdo. Para um site em que você está conectado, a ferramenta de navegador do próprio OpenClaw, rodando com a sua sessão, é a escolha certa.

## Quanto vai custar pesquisar pelo OpenClaw?

Um crédito por chamada `search_web` que lê até 3 páginas, nada para chamadas que falham. Ler páginas cujas URLs você já tem custa 1 crédito por cada grupo iniciado de 3 páginas devolvidas com conteúdo, até 20 URLs por chamada; URLs recusadas ou com falha não são contadas. Um assistente que pesquisa 25 vezes por dia em seus canais de chat usa cerca de 750 créditos por mês, então 5.000 pesquisas (US$ 9,25) dura mais de seis meses. Os créditos de pesquisa não têm data de expiração: o que você não usar este mês continua lá no ano que vem.

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

## OpenClaw: perguntas frequentes

### Devo desativar o web_search do próprio OpenClaw?

Não precisa. Os dois podem ficar ativos. Desative o integrado apenas se quiser que toda pesquisa passe por um único provedor, com uma só fatura e um só log.

### Funciona com um OpenClaw em sandbox?

O servidor MCP é um processo local que chama `https://llmwebsearch.com/api/v1` via HTTPS. Seu sandbox precisa permitir que ele inicie e alcance esse endereço.

### Posso gerenciar o servidor pela Control UI?

O OpenClaw guarda os servidores MCP salvos em `mcp.servers` na configuração dele. A documentação aponta para a Control UI para as configurações MCP ao vivo suportadas e observa que alterar servidores salvos pela linha de comando exige que o Gateway local esteja parado.

## Fontes

1. [Ferramentas web](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [Gerenciar servidores MCP salvos](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)

---

LLMWebSearch: O LLMWebSearch é uma API de pesquisa na web para agentes de IA que retorna resultados classificados com o conteúdo das principais páginas em Markdown, pago com cripto sem envio de documentos. Os créditos pré-pagos a partir de US$ 1,20/1K pesquisas nunca expiram. Sem KYC — sem documento, sem selfie, sem comprovantes. Pague com cripto.
