Vai al contenuto principale

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.

Il tuo agente OpenClaw può leggere la documentazione, ma non può leggere il web. Il plugin 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

clawhub install olostep
Ecco fatto. Se preferisci collegare manualmente il server MCP, aggiungi questo alla tua configurazione OpenClaw: 
{
  "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 — 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.

scrape

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.

search

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.

crawl

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.

batch

Estrai fino a 10.000 URL in parallelo con rendering completo. Etichetta ogni URL con custom_id per mappare i risultati alle tue fonti.

map

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.

answers

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.

research

“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.

debug-error

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.

docs-to-code

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.

migrate-code

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.

extract-schema

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.

integrate

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.

setup

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.
StrumentoCosa fa
scrape_websiteEstrai un singolo URL in markdown, HTML, JSON o testo
get_webpage_contentRecupera una pagina web come markdown pulito, pronto per LLM
search_webCerca sul web live, ottieni risposte sintetizzate dall’AI
google_searchDati strutturati SERP di Google — risultati organici, PAA, knowledge graph
answersFai una domanda, ottieni una risposta citata con output JSON strutturato opzionale
batch_scrape_urlsEstrai fino a 10.000 URL in parallelo con rendering completo
create_crawlEsplora un sito web seguendo i link da un URL di partenza
create_mapScopri tutti gli URL su un sito web, filtrabili per pattern e query
get_website_urlsTrova 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.
ParserRestituisce
@olostep/google-searchRisultati organici, knowledge graph, People Also Ask
@olostep/amazon-it-productPrezzo, valutazione, caratteristiche, disponibilità
@olostep/extract-emailsOgni indirizzo email trovato sulla pagina
@olostep/extract-calendarsEventi di calendario strutturati
@olostep/extract-socialsLink ai profili sui social media

Installa su ClawHub

Elenco dei plugin, cronologia delle versioni e installazione con un solo comando

Ottieni Chiave API

500 richieste gratuite/mese, nessuna carta di credito

Documentazione Server MCP

Configurazione completa del server MCP per Cursor, Claude Desktop e altri client

Riferimento API

Documentazione completa degli endpoint con esempi