Skip to main content
Pacchetto NPM: olostep-cli Repository: github.com/olostep-api/olostep-cli CLI per l’Olostep API — scrape, search, map, crawl, answer, e batch il web dal tuo terminale. Ogni comando restituisce JSON in modo che possa essere facilmente utilizzato con 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+.
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:
Opzioni: --skills-only, --mcp-only, --no-browser, --relogin. Per solo accedere (senza competenze/MCP):
Il browser si apre alla pagina di autenticazione Olostep; clicchi su Authorize, e la CLI salva la tua chiave localmente. Alternativa — imposta una variabile d’ambiente. Utile per CI:
Ottieni una chiave dalla dashboard delle chiavi API. Dove viene memorizzata la chiave (dopo 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

Ogni comando stampa il suo risultato JSON su stdout per impostazione predefinita. Passa --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.
Scegliere tra loro:
  • 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

Usa olostep <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.
Sincrono — controlla fino al completamento del batch, quindi recupera ogni elemento.

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 — file SKILL.md installati in Claude Code, Cursor e altri agenti in modo che sappiano cosa può fare Olostep e quando usarlo.
Filtra cosa viene installato:
Vedi Competenze per l’elenco completo e le opzioni.

Controlli di salute

Controlli: chiave API presente, chiave API raggiungibile, endpoint MCP raggiungibile, file di configurazione esiste per ogni agente rilevato. Uso CI:

Versione e aggiornamenti

Variabili d’ambiente

Note per Windows / PowerShell

PowerShell tokenizza , e * diversamente da bash — cita gli argomenti:
Le virgolette singole sono più sicure per i valori JSON (nessuna interpolazione $).

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.

Correlati