jq, agenti e CI.
JavaScript puro, Node 18+, nessun binario nativo da scaricare. Si installa in meno di un secondo, avvia in ~200 ms, distribuito come un unico bundle di ~100 KB.
Installazione
Requisiti: Node.js 18+.- npm (consigliato)
- One-liner (macOS / Linux)
- One-liner (Windows)
- No-install (npx)
olostep init è il passo successivo consigliato — effettua l’accesso, installa le competenze Olostep nei tuoi agenti AI, e configura il server MCP, tutto in un unico comando. Gli script one-liner avvolgono npm install -g olostep-cli con un controllo di Node 18+ e un fallback sudo, quindi funzionano anche se non sei sicuro della tua configurazione locale.
Piattaforme: macOS (Apple Silicon e Intel), Linux (x64 e arm64), Windows (x64 e arm64).
Configurazione
Un comando fa tutto — accesso, installazione delle competenze, e installazione del server MCP:--skills-only, --mcp-only, --no-browser, --relogin.
Per solo accedere (senza competenze/MCP):
olostep login):
Disconnessione
logout avvisa anche se le variabili d’ambiente OLOSTEP_API_KEY / OLOSTEP_API_TOKEN o un file .env nella tua directory corrente contengono ancora una chiave — queste hanno priorità sul file delle credenziali, quindi eliminare solo il file potrebbe non essere sufficiente. L’output include i comandi di unset esatti per PowerShell e bash/zsh.
Avvio rapido
--out <path> per salvare su un file.
Cosa può fare?
Output
Ogni comando stampa il suo risultato JSON su stdout per impostazione predefinita.
Le righe di progresso e log vanno su stderr, quindi stdout rimane pulito per i pipe.
search— vuoi un elenco di URL e snippet rilevanti per una query. La CLI cerca sul web per te.answer— vuoi una risposta sintetizzata, non il contenuto grezzo della pagina. La CLI fa la ricerca per te.scrape— hai già l’URL e vuoi ottenere contenuto pulito.crawl— vuoi ogni pagina su un sito (o un sottoinsieme filtrato) senza enumerare gli URL a mano.batch-scrape— hai un elenco di URL e vuoi che siano elaborati in parallelo.
Comandi
Usaolostep <command> --help per ogni opzione.
search: ricerca web live
Restituisce link organici deduplicati (URL, titolo, descrizione).
answer: risposta ricercata
Sincrono — restituisce quando la risposta è pronta.
map: scoprire URL
scrape: un URL
Formati: html, markdown, text, json, raw_pdf, screenshot (separati da virgola; predefinito markdown).
scrape-get: recupera per ID
crawl: intero sito
Avvia un crawl, controlla fino al termine, quindi recupera i contenuti delle pagine.
Formati di recupero: markdown, html, json.
Flag notevoli: --max-pages, --max-depth, --include-subdomain, --include-external, --include-url, --exclude-url, --search-query, --top-n, --webhook, --crawl-timeout, --formats, --pages-limit, --pages-search-query, --poll-seconds, --poll-timeout, --dry-run.
batch-scrape: CSV
Il CSV deve avere una riga di intestazione con colonne custom_id (o id) e url.
batch-update: metadati batch
Richiede uno di --metadata-json o --metadata-file (oggetto JSON).
Comandi di autenticazione
auth set-key è utile per CI e script — scrivi direttamente la chiave senza passare per il flusso del browser.
Installa il server MCP
La CLI scrive il server Olostep MCP nella configurazione del tuo agente — nessuna modifica JSON necessaria.
L’endpoint ospitato su
https://mcp.olostep.com/mcp utilizza Authorization: Bearer <key> — nessun processo Node locale richiesto. La CLI unisce solo la chiave olostep nella tua configurazione esistente. Riavvia il tuo agente dopo l’installazione.
Competenze per agenti AI
La CLI distribuisce 13 competenze Olostep — fileSKILL.md installati in Claude Code, Cursor e altri agenti in modo che sappiano cosa può fare Olostep e quando usarlo.
Controlli di salute
Versione e aggiornamenti
Variabili d’ambiente
Note per Windows / PowerShell
PowerShell tokenizza, e * diversamente da bash — cita gli argomenti:
$).
Vedi cosa è installato
Flag globali
--out, --timeout, e --api-key sono disponibili su ogni comando dati.
Sicurezza
Tieni le chiavi API fuori dal controllo del codice sorgente; ruotale se vengono divulgate.olostep logout rimuove il file delle credenziali locale e ti dice se eventuali fonti di variabili d’ambiente contengono ancora una chiave.