Installazione

La CLI di Octoparse è distribuita come pacchetto npm e viene eseguita su Node.js 20 o versioni successive.

Requisiti

Prima di installare la CLI di Octoparse, assicurati che il tuo ambiente disponga di:

Node.js 20 o versione successiva
npm 8 o versione successiva
Un terminale o una shell da riga di comando

Controlla le versioni di Node.js e npm:

node -v
npm -v

Se la versione di Node.js è precedente alla 20, aggiornala prima di continuare.

Scarica Node.js

Installa Node.js 20 o versione successiva per il tuo sistema operativo.

Piattaforme supportate per l’estrazione locale

L’estrazione locale usa un runtime Chrome indipendente. Piattaforme supportate:

macOS (x64 e arm64)
Windows (x64)
Linux (x64)

Linux arm64 non è supportato per l’estrazione locale. Chrome for Testing non fornisce un pacchetto per Linux arm64. Se utilizzi un server ARM o un container Apple Silicon con un’immagine Linux arm64, i comandi locali run e detect non riusciranno. L’estrazione cloud (octoparse cloud start) funziona su qualsiasi piattaforma.

Installa con npm

Installa globalmente la CLI di Octoparse:

npm install -g @octoparse-ai/octoparse-cli

Dopo l’installazione, il comando octoparse è disponibile a livello globale.

Verifica l’installazione

Controlli rapidi

Controlla la versione installata:

octoparse --version

Apri l’output della guida:

octoparse --help

Comprendi l’output di doctor

Esegui la diagnostica:

octoparse doctor

octoparse doctor controlla Node.js, il motore Octoparse integrato, le estensioni di runtime, la disponibilità di Chrome e la modalità browser. Un risultato riuscito restituisce "ok": true:

{
  "ok": true,
  "checks": [
    { "name": "node", "ok": true, "message": "v24.0.0" },
    { "name": "engine", "ok": true, "message": "..." },
    { "name": "electron-client", "ok": true, "message": "not required" },
    { "name": "browser-mode", "ok": true, "message": "independent Chrome only" }
  ]
}

electron-client: not required: l’app desktop Octoparse non è necessaria per l’esecuzione tramite CLI.
browser-mode: independent Chrome only: l’estrazione locale usa un runtime Chrome indipendente, non il browser del client desktop.

Se chrome mostra ok: false, consulta Risoluzione dei problemi di seguito. Se necessario, usa un percorso Chrome personalizzato:

octoparse doctor --chrome-path /path/to/chrome

Controlla che il browser utente sia pronto

octoparse browser status

Usa l’output JSON per controlli strutturati dell’ambiente e del browser utente:

octoparse doctor --json
octoparse browser status --json

Gestisci l’installazione

Aggiorna la CLI di Octoparse

Esegui nuovamente il comando di installazione npm per aggiornare:

npm install -g @octoparse-ai/octoparse-cli
octoparse --version

Disinstalla la CLI di Octoparse

npm uninstall -g @octoparse-ai/octoparse-cli

Se la shell restituisce octoparse: command not found, il comando è stato rimosso.

Risoluzione dei problemi

Problema	Cosa controllare
`octoparse: command not found`	Verifica che la directory globale dei file binari npm sia nel tuo `PATH`
Errore di autorizzazione durante l’installazione	Controlla le autorizzazioni globali dei pacchetti npm o usa un gestore di versioni Node.js. Consulta la guida npm →
Versione di Node.js troppo vecchia	Aggiorna a Node.js 20 o versione successiva
Timeout di npm install	Controlla il registro npm e le impostazioni di Proxy, VPN o firewall
Download di Chrome non riuscito	Controlla l’accesso di rete alla CDN di Chrome for Testing. Prova `--chrome-path` per usare un Chrome installato localmente
Linux arm64 non supportato	Usa un ambiente Linux x64 oppure passa all’estrazione cloud con `octoparse cloud start`
`doctor` mostra un controllo non riuscito	Correggi la dipendenza segnalata (Node.js, Chrome, file del motore), quindi esegui nuovamente `octoparse doctor`. Condividi l’output `ok: false` con l’assistenza Octoparse se il problema persiste

Passaggi successivi

Ottieni una chiave API e accedi

Crea una chiave API Octoparse ed esegui l’autenticazione della CLI.

Esegui la tua prima attività

Elenca le attività, esaminane una, eseguila in locale ed esporta i dati.

Esplora tutti i comandi

Esamina i comandi CLI comuni per attività, esecuzioni locali, esecuzioni cloud ed esportazioni.

PANORAMICA

PER INIZIARE

CREARE ATTIVITÀ

ATTIVITÀ ED ESECUZIONI

DATI

AUTOMAZIONE

RIFERIMENTO

Requisiti

Scarica Node.js

Piattaforme supportate per l’estrazione locale

Installa con npm

Verifica l’installazione

Controlli rapidi

Comprendi l’output di doctor

Controlla che il browser utente sia pronto

Gestisci l’installazione

Aggiorna la CLI di Octoparse

Disinstalla la CLI di Octoparse

Risoluzione dei problemi

Passaggi successivi

Ottieni una chiave API e accedi

Esegui la tua prima attività

Esplora tutti i comandi

​Requisiti

Scarica Node.js

​Piattaforme supportate per l’estrazione locale

​Installa con npm

​Verifica l’installazione

​Controlli rapidi

​Comprendi l’output di doctor

​Controlla che il browser utente sia pronto

​Gestisci l’installazione

​Aggiorna la CLI di Octoparse

​Disinstalla la CLI di Octoparse

​Risoluzione dei problemi

​Passaggi successivi

Ottieni una chiave API e accedi

Esegui la tua prima attività

Esplora tutti i comandi

Requisiti

Piattaforme supportate per l’estrazione locale

Installa con npm

Verifica l’installazione

Controlli rapidi

Comprendi l’output di doctor

Controlla che il browser utente sia pronto

Gestisci l’installazione

Aggiorna la CLI di Octoparse

Disinstalla la CLI di Octoparse

Risoluzione dei problemi

Passaggi successivi