> ## Documentation Index > Fetch the complete documentation index at: https://docs.olostep.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrazione Olostep + OpenClaw > Fornisci al tuo agente OpenClaw accesso web live con 13 abilità e un server MCP a 9 strumenti Il tuo agente OpenClaw può leggere la documentazione, ma non può leggere il web. Il [plugin Olostep Web Agent](https://clawhub.ai/plugins/olostep-web-agent) risolve questo problema — cerca, estrae, esplora e raccoglie dati strutturati da qualsiasi sito web, direttamente all'interno del flusso di lavoro del tuo agente. Un'installazione ti offre **13 abilità** per compiti di alto livello (debug di un errore da thread StackOverflow live, scrittura di codice di integrazione dai documenti correnti, ricerca di strumenti con confronti strutturati) e un **server MCP a 9 strumenti** per l'accesso programmatico diretto. SPA pesanti in JS, CAPTCHA, Cloudflare, proxy residenziali — gestiti automaticamente. ## Installazione ```bash theme={null} clawhub install olostep ``` Ecco fatto. Se preferisci collegare manualmente il server MCP, aggiungi questo alla tua configurazione OpenClaw: ```json theme={null} { "mcpServers": { "olostep": { "command": "npx", "args": ["-y", "olostep-mcp"], "env": { "OLOSTEP_API_KEY": "your-api-key-here" } } } } ``` Ottieni una chiave API gratuita su [olostep.com/auth](https://olostep.com/auth) — 500 richieste/mese, nessuna carta di credito. ## Abilità ### Abilità di Base sui Dati Queste sei abilità sono i mattoni fondamentali. Ognuna fa una cosa bene, e il tuo agente può comporle per flussi di lavoro complessi. Qualsiasi URL in markdown pulito, HTML, JSON o testo. Rendering completo del browser, bypass anti-bot, targeting geografico, azioni del browser (clic, scroll, digitazione) e parser pre-costruiti per tipi di siti comuni. Tre modalità: risposte sintetizzate dall'AI con citazioni, dati grezzi SERP di Google (risultati organici, PAA, knowledge graph) e scoperta di URL a livello di dominio. Inizia da un URL, segui i link, estrai ogni pagina scoperta. Imposta il numero massimo di pagine, includi/escludi pattern di URL e controlla la profondità dell'esplorazione. Estrai fino a 10.000 URL in parallelo con rendering completo. Etichetta ogni URL con `custom_id` per mappare i risultati alle tue fonti. Scopri ogni URL su un sito web senza estrarne nessuno. Filtra per pattern glob, classifica per rilevanza della query di ricerca, limita con `top_n`. Fai una domanda in linguaggio naturale, ottieni una risposta sintetizzata dall'AI basata su fonti web live. Passa un parametro `json` per ottenere un output strutturato che corrisponde a qualsiasi schema tu definisca. ### Abilità di Flusso di Lavoro Queste sette abilità concatenano insieme più operazioni di base. Gestiscono il pensiero — il tuo agente sceglie solo l'abilità giusta per il lavoro. "Confronta i primi 3 ORM per Node.js" — l'agente cerca in più fonti, estrae pagine di prezzi e caratteristiche, e restituisce un confronto strutturato con citazioni e una raccomandazione. Incolla un traceback o un messaggio di errore. L'agente cerca problemi su GitHub e StackOverflow per quell'errore esatto, estrae i thread rilevanti e restituisce una soluzione basata su ciò che gli sviluppatori che hanno affrontato lo stesso problema hanno effettivamente fatto. Indica un URL di documentazione. L'agente estrae il riferimento API corrente e scrive codice di integrazione funzionante da ciò che è effettivamente pubblicato — non da dati di addestramento obsoleti che potrebbero fare riferimento a metodi deprecati. Fornisci la tua versione corrente e la versione di destinazione. L'agente estrae la guida alla migrazione, estrae ogni modifica critica con pattern prima/dopo e riscrive il tuo codice per adattarlo. Trasforma qualsiasi pagina web non strutturata — elenchi di prodotti, annunci di lavoro, articoli — in JSON tipizzato che corrisponde a un'interfaccia TypeScript, uno schema JSON o un modello di database che fornisci. Rileva automaticamente il tuo stack (linguaggio, framework, toolkit AI) e scrive un'integrazione completa dell'SDK Olostep: comandi di installazione, configurazione del client, collegamento degli strumenti e un passaggio di verifica. Configura la chiave API Olostep e verifica la connessione. Include la risoluzione dei problemi per i problemi di configurazione comuni. ## Strumenti MCP Il server MCP incluso (`olostep-mcp`) fornisce al tuo agente 9 strumenti che può chiamare direttamente. Usali quando hai bisogno di un controllo dettagliato oltre a ciò che le abilità di flusso di lavoro forniscono. | Strumento | Cosa fa | | --------------------- | ---------------------------------------------------------------------------------- | | `scrape_website` | Estrai un singolo URL in markdown, HTML, JSON o testo | | `get_webpage_content` | Recupera una pagina web come markdown pulito, pronto per LLM | | `search_web` | Cerca sul web live, ottieni risposte sintetizzate dall'AI | | `google_search` | Dati strutturati SERP di Google — risultati organici, PAA, knowledge graph | | `answers` | Fai una domanda, ottieni una risposta citata con output JSON strutturato opzionale | | `batch_scrape_urls` | Estrai fino a 10.000 URL in parallelo con rendering completo | | `create_crawl` | Esplora un sito web seguendo i link da un URL di partenza | | `create_map` | Scopri tutti gli URL su un sito web, filtrabili per pattern e query | | `get_website_urls` | Trova e recupera URL rilevanti da un dominio specifico | ## Come Si Presenta in Pratica ### "Perché sta fallendo?" — Debug dal web live Incolli `ECONNRESET quando chiami l'endpoint webhook di Stripe` nel tuo agente. Cerca problemi su GitHub e StackOverflow per quell'errore esatto, estrae i tre thread più rilevanti e restituisce una soluzione concreta — non "controlla le impostazioni di rete", ma la configurazione del timeout effettiva che l'ha risolto per altri sviluppatori che hanno affrontato lo stesso ostacolo. ### "Scrivi l'integrazione" — Codice dai documenti correnti, non da dati di addestramento obsoleti Hai bisogno di integrare un'API di pagamento. L'abilità `docs-to-code` estrae il riferimento API corrente — quello pubblicato oggi, non la versione su cui il tuo modello è stato addestrato sei mesi fa — e scrive codice funzionante utilizzando i parametri e gli endpoint che esistono effettivamente. ### "Quale dovrei usare?" — Confronti strutturati degli strumenti Valutando gli ORM? Confrontando i fornitori di autenticazione? L'abilità `research` cerca in più fonti, estrae pagine di prezzi reali e matrici di caratteristiche, e restituisce una tabella di confronto strutturata con citazioni. Ricevi una raccomandazione supportata da ciò che è effettivamente sul sito web di ciascun prodotto, non dalla popolarità nei dati di addestramento. ### Costruisci una pipeline RAG da qualsiasi sito di documentazione ``` map → scopri ogni URL sul sito di documentazione batch → estrai tutte le pagine in parallelo come markdown pulito → alimenta nel tuo archivio vettoriale ``` Due abilità, una pipeline. Funziona su siti di documentazione con centinaia o migliaia di pagine. ### Estrai dati strutturati su larga scala ``` map → trova tutti gli URL di prodotti, elenchi o annunci di lavoro batch → estrai ogni pagina con un parser pre-costruito → JSON tipizzato → inserisci nel tuo database, API o file di seed ``` ### Migra a una nuova versione del framework Stai aggiornando Next.js dalla versione 13 alla 15. L'abilità `migrate-code` estrae la guida ufficiale alla migrazione, estrae ogni modifica critica con pattern di codice prima/dopo e riscrive i tuoi file per adattarli — basato sulla documentazione reale, non sulla migliore ipotesi del modello. ## Parser Pre-costruiti Passa il parametro `parser` a qualsiasi chiamata di estrazione e ottieni JSON tipizzato invece di contenuto grezzo. Nessuna definizione di schema necessaria — questi gestiscono l'estrazione per te. | Parser | Restituisce | | ---------------------------- | ---------------------------------------------------- | | `@olostep/google-search` | Risultati organici, knowledge graph, People Also Ask | | `@olostep/amazon-it-product` | Prezzo, valutazione, caratteristiche, disponibilità | | `@olostep/extract-emails` | Ogni indirizzo email trovato sulla pagina | | `@olostep/extract-calendars` | Eventi di calendario strutturati | | `@olostep/extract-socials` | Link ai profili sui social media | ## Link Elenco dei plugin, cronologia delle versioni e installazione con un solo comando 500 richieste gratuite/mese, nessuna carta di credito Configurazione completa del server MCP per Cursor, Claude Desktop e altri client Documentazione completa degli endpoint con esempi