Skip to main content
Octoparse CLI è uno strumento da riga di comando per creare, eseguire, gestire, pianificare, controllare ed esportare le attività di Octoparse da un terminale. A differenza dell’app desktop, Octoparse CLI è progettato per flussi di lavoro basati su script, pipeline CI/CD, ambienti server e pipeline di dati automatizzate.

Cosa puoi fare con Octoparse CLI

Creare attività da un URL

Esamina qualsiasi URL e genera automaticamente un file di attività locale, in modo manuale oppure tramite un flusso di lavoro con agente AI.

Trovare e gestire le attività

Elenca le attività cloud, effettua ricerche per parola chiave, esamina i dettagli delle attività e lavora con i gruppi di attività.

Creare attività dai modelli

Visualizza e cerca i modelli, crea attività di modello e modificale.

Eseguire le attività in locale

Esegui le attività Octoparse con il motore locale integrato e un’istanza indipendente di Chrome.

Scegliere una modalità browser

Usa un’istanza indipendente di Chrome oppure riutilizza un profilo Chrome o Edge con una sessione già attiva.

Eseguire e pianificare le attività cloud

Avvia l’estrazione cloud, consulta la cronologia e configura pianificazioni ricorrenti.

Controllare ed esportare i dati

Verifica il numero di record, visualizza l’anteprima delle righe, controlla i dati non esportati ed esporta i risultati locali o cloud.

Automatizzare con gli agenti

Usa l’output JSON, i flussi di eventi JSONL e i codici di uscita per integrare la CLI in script e agenti AI.

Come funziona

Per l’estrazione locale, Octoparse CLI esegue direttamente il motore Octoparse integrato. Utilizza un’istanza indipendente di Chrome e non richiede il client desktop Electron. L’estrazione cloud viene controllata tramite le API di backend, mentre l’estrazione locale è gestita dal motore locale.
Lo stato dell’esecuzione locale viene monitorato da questa CLI e non è sincronizzato con lo stato del client desktop Octoparse.

Requisiti

Prima di utilizzare Octoparse CLI, assicurati di disporre di:
  • Node.js 20 o versione successiva
  • npm 8 o versione successiva
  • Un account Octoparse (chiave API o OAuth)
  • Accesso alle attività da eseguire o esportare
Consulta Installazione per conoscere i requisiti delle piattaforme e i passaggi di configurazione, incluse le limitazioni di Linux arm64. I comandi operativi richiedono l’autenticazione, comprese le esecuzioni locali con --task-file e .otd. I comandi di configurazione e diagnostica, come --help, --version, doctor, browser, capabilities e auth, possono essere eseguiti senza autenticazione.

Flusso di lavoro comune

1

Installa Octoparse CLI

Installa la CLI globalmente con npm.
2

Autenticati

Accedi con OAuth o con una chiave API Octoparse. Per la CI, usa la variabile di ambiente OCTO_ENGINE_API_KEY.
Non inserire le chiavi API nei commit Git, negli script, nella documentazione, negli screenshot, nei log condivisi o nell’output della CI.
3

Crea o trova un'attività

Usa octoparse detect <url> per generare un file di attività da un URL, crea un’attività da un modello oppure usa octoparse task list per trovare l’ID di un’attività esistente.
4

Esegui o controlla l'attività

Esegui l’attività in locale, avvia o interrompi un’esecuzione cloud, configura una pianificazione cloud oppure verifica lo stato dell’esecuzione.
5

Controlla ed esporta i dati

Verifica lo stato dei dati, visualizza l’anteprima delle righe, controlla i dati non esportati oppure esporta i dati raccolti dai risultati locali o cloud.

Esempi rapidi di comandi

Sostituisci <taskId> con l’ID effettivo dell’attività e <url> con la pagina da sottoporre a scraping.

Limitazioni attuali

Octoparse CLI v1 non supporta il browser kernel né il flusso di lavoro legacy. Il browser kernel indica la modalità browser utilizzata dai flussi di lavoro delle versioni precedenti del runtime Octoparse. Il flusso di lavoro legacy indica le attività create con definizioni precedenti delle attività Octoparse, non supportate dal runtime CLI attuale. Se un’attività non è supportata, ricreala o aggiornala nell’app desktop Octoparse corrente, quindi eseguila di nuovo con la CLI.

Passaggi successivi

Installa Octoparse CLI

Configura Node.js, installa la CLI con npm e verifica il runtime locale.

Crea attività da un URL

Usa detect per generare un file di attività da qualsiasi URL.

Consulta tutti i comandi

Consulta i comandi per attività, modelli, pianificazioni, detect, esecuzioni locali e cloud, autenticazione ed esportazione.