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

# Installazione

> Installa la CLI di Octoparse con npm, controlla i requisiti di Node.js e della piattaforma e verifica che il motore locale, Chrome e il browser utente siano pronti.

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:

```bash theme={null}
node -v
npm -v
```

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

<Card title="Scarica Node.js" href="https://nodejs.org/">
  Installa Node.js 20 o versione successiva per il tuo sistema operativo.
</Card>

### Piattaforme supportate per l'estrazione locale

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

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

<Warning>
  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.
</Warning>

## Installa con npm

Installa globalmente la CLI di Octoparse:

```bash theme={null}
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:

```bash theme={null}
octoparse --version
```

Apri l'output della guida:

```bash theme={null}
octoparse --help
```

### Comprendi l'output di doctor

Esegui la diagnostica:

```bash theme={null}
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`:

```json theme={null}
{
  "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](#troubleshooting) di seguito.

Se necessario, usa un percorso Chrome personalizzato:

```bash theme={null}
octoparse doctor --chrome-path /path/to/chrome
```

### Controlla che il browser utente sia pronto

```bash theme={null}
octoparse browser status
```

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

```bash theme={null}
octoparse doctor --json
octoparse browser status --json
```

## Gestisci l'installazione

### Aggiorna la CLI di Octoparse

Esegui nuovamente il comando di installazione npm per aggiornare:

```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
octoparse --version
```

### Disinstalla la CLI di Octoparse

```bash theme={null}
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 →](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) |
| 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

<CardGroup cols={3}>
  <Card title="Ottieni una chiave API e accedi" href="/docs/it/cli/quick-start/get-api-key-and-log-in">
    Crea una chiave API Octoparse ed esegui l'autenticazione della CLI.
  </Card>

  <Card title="Esegui la tua prima attività" href="/docs/it/cli/quick-start/run-your-first-task">
    Elenca le attività, esaminane una, eseguila in locale ed esporta i dati.
  </Card>

  <Card title="Esplora tutti i comandi" href="../reference/command-cheatsheet">
    Esamina i comandi CLI comuni per attività, esecuzioni locali, esecuzioni cloud ed esportazioni.
  </Card>
</CardGroup>