# OpenClaw: aggiungi un lettore di pagine web tramite MCP, accanto a web_fetch

> Aggiungi un lettore di pagine web a OpenClaw via MCP: openclaw mcp add, doctor --probe e read_url integra web_fetch. Senza KYC, paghi in criptovalute.

- URL: https://webreaderapi.com/it/docs/openclaw/
- Ultimo aggiornamento: 2026-10-22
- Editore: WebReaderAPI (https://webreaderapi.com)

OpenClaw ha già un tool `web_fetch` per le pagine leggere. Aggiungere il nostro server MCP dà all'agente un secondo lettore, `read_url`, per pagine JavaScript, PDF e documenti più lunghi. La configurazione è un solo comando.

**Risposta rapida — Come aggiungo un'API per leggere pagine web a OpenClaw?**

Salva il server MCP **WebReaderAPI**, poi registralo con `openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=…` e verificalo con `openclaw mcp doctor --probe`. L'agente ottiene un tool `read_url` accanto al `web_fetch` integrato, capace di renderizzare JavaScript e leggere PDF. Le pagine costano 1 credito, a partire da 0,07 USD/1K pagine a ottobre 2026. Senza KYC; paghi in criptovalute.

## web_fetch e read_url di OpenClaw a confronto

| Attributo | Valore |
| --- | --- |
| web_fetch (integrato) | Gira in locale, estrae il contenuto principale con Readability, restituisce Markdown o testo |
| limiti di web_fetch | Nessuna esecuzione JavaScript; `maxChars` predefinito e limite di 20.000 caratteri (docs di OpenClaw) |
| read_url (il nostro tool MCP) | Rendering JavaScript quando serve, PDF fino a 100 pagine, fino a 500.000 caratteri |
| costo di read_url | 1 credito = 1 pagina letta senza browser; 2 crediti quando la pagina richiede un browser per eseguire JavaScript. Una richiesta che fallisce, o che il robots.txt di un sito rifiuta, non viene addebitata |
| Il nostro crawler | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt rispettato |
| Profili degli strumenti | Gli strumenti MCP compaiono nei profili `coding` e `messaging`, non in `minimal` |

## Perché aggiungere un reader quando OpenClaw ha web_fetch?

Perché coprono pagine diverse. La documentazione di OpenClaw dice che `web_fetch` gira sempre in locale, usa Readability per estrarre il contenuto principale e non esegue JavaScript; per i siti con molto JavaScript o protetti da login rimanda al suo strumento Web Browser. La sua impostazione `maxChars` è di 20.000 caratteri per impostazione predefinita ed è limitata a quel valore.

Tieni `web_fetch` per le pagine veloci e leggere. Aggiungi `read_url` per le pagine che costruiscono il contenuto con JavaScript, per i PDF e per i documenti lunghi in cui vuoi più di 20.000 caratteri. La documentazione di OpenClaw segnala anche che il plugin ufficiale Firecrawl è oggi l'unico provider incluso su cui `web_fetch` può ricadere.

## Come registro il server MCP in OpenClaw?

Prima prepara il server Python dalla [pagina MCP](https://webreaderapi.com/it/docs/mcp/): un file più i pacchetti `mcp` e `httpx`. Poi salvalo in OpenClaw con `openclaw mcp add`. La documentazione del registry di OpenClaw descrive i flag stdio `--command`, `--arg`, `--env` e `--cwd`, e salva le definizioni sotto `mcp.servers` nella sua configurazione.

Dopo esegui `openclaw mcp doctor --probe`. Senza `--probe` il doctor controlla solo la configurazione salvata; con esso verifica anche che i server abilitati si connettano.

*Registra e controlla il server*

```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
```

## L'agente vedrà read_url?

Nei profili abituali, sì. La documentazione del registry di OpenClaw dice che OpenClaw incorporato espone gli strumenti MCP configurati nei profili `coding` e `messaging`. Il profilo `minimal` li nasconde e `tools.deny: ["bundle-mcp"]` li disattiva, quindi controlla queste due impostazioni se lo strumento non compare.

La descrizione dello strumento indica al modello quando preferirlo: pagine che richiedono JavaScript, PDF e letture lunghe. Il modello può comunque usare `web_fetch` per tutto il resto.

## Come tratta read_url i siti che legge?

Allo stesso modo di ogni chiamata alla nostra API. Rispettiamo robots.txt: il nostro crawler si identifica come WebReaderAPI, segue le regole scritte per lui o per tutti i robot e non legge una pagina che un sito vieta. Le pagine rifiutate non vengono addebitate. Se un sito dichiara Content-Signal: ai-input=no nel suo robots.txt, non leggiamo le sue pagine per te. Se un sito rifiuta la nostra richiesta, restituiamo la sua risposta: non risolviamo mai CAPTCHA, non accediamo agli account e non tentiamo di aggirare un blocco o un paywall.

Le pagine dietro un login sono quindi fuori portata per `read_url`. Per un sito in cui hai effettuato l'accesso, lo strumento browser di OpenClaw, eseguito con la tua sessione, è quello giusto.

## Quanto costa leggere pagine tramite OpenClaw?

Un credito per ogni pagina che restituisce contenuto, due quando serve un browser, nulla per rifiuti ed errori. Un assistente che legge 30 pagine al giorno sui suoi canali di chat usa circa 900 crediti al mese: 10.000 pagine (3,75 USD) dura quasi un anno. I crediti prepagati non scadono mai: le pagine non utilizzate restano sul tuo account finché non le usi.

Dai a OpenClaw una chiave API dedicata, così il suo utilizzo risulta separato dagli altri tuoi progetti.

## OpenClaw: domande frequenti

### WebReaderAPI è un provider integrato di OpenClaw?

No. Si connette come server MCP, che OpenClaw supporta senza alcun codice di plugin. Il server MCP è il breve file Python della nostra [pagina MCP](https://webreaderapi.com/it/docs/mcp/).

### Dovrei disattivare web_fetch?

Non serve. Entrambi gli strumenti possono restare attivi; le descrizioni indicano al modello quale si adatta. Disattiva `web_fetch` solo se vuoi che ogni lettura passi da un unico punto per il logging.

### Posso gestire il server dall'interfaccia web di OpenClaw?

La documentazione di OpenClaw descrive le impostazioni MCP nella sua Control UI, che modificano le stesse definizioni salvate della riga di comando. Usa quella che preferisci.

### Funziona in un'installazione OpenClaw in sandbox?

Il server MCP è un processo locale che ha bisogno di accesso a internet per raggiungere `https://webreaderapi.com/api/v1/read`. Verifica che la tua sandbox permetta al processo di avviarsi e di effettuare quella chiamata HTTPS.

## Fonti

1. [Strumenti 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. [Gestisci i server MCP salvati](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)
4. [MCP nella Control UI](https://docs.openclaw.ai/cli/mcp/control-ui) — OpenClaw docs (read 2026-10-22)

---

WebReaderAPI: WebReaderAPI è un'API web reader per agenti AI che converte qualsiasi pagina web pubblica in Markdown pulito, con pagamento in criptovalute e senza caricare documenti d'identità. I crediti prepagati da 0,07 USD/1K pagine non scadono mai e robots.txt viene rispettato. Senza KYC — niente documento, niente selfie, niente documenti. Paga in criptovalute.
