> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Octoparse CLI

> Usa Octoparse CLI per creare, eseguire, gestire, pianificare, controllare, automatizzare ed esportare attività in locale o nel cloud.

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

<CardGroup cols={2}>
  <Card title="Creare attività da un URL" icon="wand-magic-sparkles" href="./cli/guides/detect">
    Esamina qualsiasi URL e genera automaticamente un file di attività locale, in modo manuale oppure tramite un flusso di lavoro con agente AI.
  </Card>

  <Card title="Trovare e gestire le attività" icon="magnifying-glass" href="./cli/guides/tasks-and-groups">
    Elenca le attività cloud, effettua ricerche per parola chiave, esamina i dettagli delle attività e lavora con i gruppi di attività.
  </Card>

  <Card title="Creare attività dai modelli" icon="table-cells" href="./cli/guides/templates">
    Visualizza e cerca i modelli, crea attività di modello e modificale.
  </Card>

  <Card title="Eseguire le attività in locale" icon="play" href="./cli/guides/local-runs">
    Esegui le attività Octoparse con il motore locale integrato e un'istanza indipendente di Chrome.
  </Card>

  <Card title="Scegliere una modalità browser" icon="window" href="./cli/guides/browser-modes">
    Usa un'istanza indipendente di Chrome oppure riutilizza un profilo Chrome o Edge con una sessione già attiva.
  </Card>

  <Card title="Eseguire e pianificare le attività cloud" icon="calendar" href="./cli/guides/cloud-runs-and-schedules">
    Avvia l'estrazione cloud, consulta la cronologia e configura pianificazioni ricorrenti.
  </Card>

  <Card title="Controllare ed esportare i dati" icon="file-export" href="./cli/guides/data">
    Verifica il numero di record, visualizza l'anteprima delle righe, controlla i dati non esportati ed esporta i risultati locali o cloud.
  </Card>

  <Card title="Automatizzare con gli agenti" icon="robot" href="./cli/guides/automation">
    Usa l'output JSON, i flussi di eventi JSONL e i codici di uscita per integrare la CLI in script e agenti AI.
  </Card>
</CardGroup>

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

<Note>
  Lo stato dell'esecuzione locale viene monitorato da questa CLI e non è sincronizzato con lo stato del client desktop Octoparse.
</Note>

## 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](./cli/quick-start/installation) 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

<Steps>
  <Step title="Installa Octoparse CLI">
    Installa la CLI globalmente con npm.
  </Step>

  <Step title="Autenticati">
    Accedi con OAuth o con una chiave API Octoparse. Per la CI, usa la variabile di ambiente `OCTO_ENGINE_API_KEY`.

    <Warning>
      Non inserire le chiavi API nei commit Git, negli script, nella documentazione, negli screenshot, nei log condivisi o nell'output della CI.
    </Warning>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Esempi rapidi di comandi

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

```bash theme={null}
octoparse --help
octoparse doctor
octoparse auth login
octoparse detect <url> --auto --goal "Extract product titles and prices" --output task.json
octoparse task list
octoparse task inspect <taskId>
octoparse capabilities --json
octoparse run <taskId>
octoparse cloud start <taskId>
octoparse local status <taskId>
octoparse data export <taskId> --source local --format xlsx
```

## 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

<CardGroup cols={3}>
  <Card title="Installa Octoparse CLI" icon="download" href="./cli/quick-start/installation">
    Configura Node.js, installa la CLI con npm e verifica il runtime locale.
  </Card>

  <Card title="Crea attività da un URL" icon="wand-magic-sparkles" href="./cli/guides/detect">
    Usa detect per generare un file di attività da qualsiasi URL.
  </Card>

  <Card title="Consulta tutti i comandi" icon="list-check" href="./cli/reference/command-cheatsheet">
    Consulta i comandi per attività, modelli, pianificazioni, detect, esecuzioni locali e cloud, autenticazione ed esportazione.
  </Card>
</CardGroup>