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

# Riferimento dei comandi della CLI di Octoparse

> Indice rapido della sintassi per autenticazione, browser, attività, modelli, detect, esecuzione locale, pianificazione cloud, automazione e dati della CLI Octoparse.

Usa questa pagina come indice della sintassi. Segui le guide collegate per configurazione, comportamento, esempi e risoluzione dei problemi.

La maggior parte dei comandi funzionali richiede l'autenticazione. Le parentesi angolari, ad esempio `<taskId>`, indicano segnaposto obbligatori.

## Famiglie di comandi

| Obiettivo                           | Comandi                             | Guida                                                                   |
| ----------------------------------- | ----------------------------------- | ----------------------------------------------------------------------- |
| Installa ed esegui l'autenticazione | `auth`, `doctor`                    | [Autenticazione](../quick-start/get-api-key-and-log-in)                 |
| Scegli un browser                   | `browser`                           | [Modalità browser](../guides/browser-modes)                             |
| Gestisci attività                   | `task`, `task-group`                | [Attività e gruppi](../guides/tasks-and-groups)                         |
| Usa modelli                         | `template`, `template-task`         | [Usa i modelli](../guides/templates)                                    |
| Crea da un URL                      | `detect`                            | [Crea attività da un URL](../guides/detect)                             |
| Esegui in locale                    | `run`, `local`                      | [Esecuzioni locali](../guides/local-runs)                               |
| Esegui nel cloud                    | `cloud`, `schedule`                 | [Esecuzioni cloud e pianificazioni](../guides/cloud-runs-and-schedules) |
| Controlla ed esporta i dati         | `data`                              | [Dati ed esportazione](../guides/data)                                  |
| Automatizza                         | `capabilities`, `--json`, `--jsonl` | [Automazione e agenti](../guides/automation)                            |

## Aiuto e diagnostica

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

## Autenticazione

```bash theme={null}
octoparse auth login
octoparse auth login --oauth
octoparse auth login <apiKey>
octoparse auth login --stdin
octoparse auth status --json
octoparse auth info --json
octoparse auth logout
```

## Attività e gruppi

```bash theme={null}
octoparse task list [--page <n>] [--page-size <n>] [--limit <n>] [--keyword <text>] [--task-group <groupId>] [--template-id <id>] [--json]
octoparse task show <taskId> [--json]
octoparse task copy <taskId> [--task-group <groupId>] [--json]
octoparse task rename <taskId> --name <name> --yes [--json]
octoparse task move <taskId> --task-group <groupId> --yes [--json]
octoparse task delete <taskId> --yes [--json]
octoparse task inspect <taskId> [--task-file <file.json|file.xml|file.otd>] [--json]
octoparse task validate <taskId> [--task-file <file.json|file.xml|file.otd>] [--json]

octoparse task-group list [--json]
octoparse task-group create <name> [--json]
octoparse task-group update <groupId> --name <name> --yes [--json]
octoparse task-group delete <groupId> --yes [--json]
octoparse task-group set-default <groupId> --yes [--json]
```

## Modelli

```bash theme={null}
octoparse template search <keyword> [--page <n>] [--page-size <n>] [--sort <n>] [--json]
octoparse template view <templateId> [--json]
octoparse template version <templateId> [--json]
octoparse template-task create <templateId> [--name <taskName>] [--task-group <groupId>] [--param key=value]... [--params <json>|--params-file <file>] [--dry-run] [--json]
octoparse template-task update <taskId> [--params <json>|--params-file <file>] --yes [--json]
```

## Detect e browser

```bash theme={null}
octoparse detect <url> --auto [--goal <text>] [--output task.json] [--json]
octoparse detect <url> --manual [--goal <text>] [--output task.json]
octoparse detect <url> --agent --agent-command <cmd> [--goal <text>] [--run-sample <n>] [--json]

octoparse browser use independent|user [--browser-id chrome|edge] [--profile <name>] [--json]
octoparse browser status [--browser-id chrome|edge] [--profile <name>] [--json]
octoparse browser profiles [--browser-id chrome|edge] [--json]
octoparse browser install [--browser-id chrome|edge] [--profile <name>] [--force-close] [--json]
```

## Esecuzioni locali

```bash theme={null}
octoparse run <taskId> [--task-file <file>] [--output <dir>] [--max-rows <n>] [--detach] [--headless] [--json|--jsonl]
octoparse local status <taskId> [--output <dir>] [--json]
octoparse local pause <taskId> [--json]
octoparse local resume <taskId> [--json]
octoparse local stop <taskId> [--json]
octoparse local history <taskId> [--output <dir>] [--json]
octoparse local cleanup [--json]
```

## Esecuzioni cloud e pianificazioni

```bash theme={null}
octoparse cloud start <taskId> [--json]
octoparse cloud stop <taskId> [--json]
octoparse cloud status <taskId> [--json]
octoparse cloud history <taskId> [--json]

octoparse schedule cloud get <taskId> [--json]
octoparse schedule cloud next --type <type> --date <value> --time <value> [--month <value>] [--json]
octoparse schedule cloud update <taskId> --type <type> --date <value> --time <value> [--month <value>] [--enabled true|false] --yes [--json]
octoparse schedule cloud start <taskId> --yes [--json]
octoparse schedule cloud stop <taskId> --yes [--json]
```

## Dati

```bash theme={null}
octoparse data history <taskId> [--source local|cloud] [--output <dir>] [--json]
octoparse data count <taskId> [--source local|cloud] [--unexported] [--json]
octoparse data preview <taskId> [--source local|cloud] [--limit <n>] [--offset <n>] [--unexported] [--json]
octoparse data export <taskId> [--source local|cloud] [--file <result.xlsx>] [--lot-id <lotId>] [--output <dir>] [--format xlsx|csv|html|json|xml] [--unexported] [--json]
```

## Comandi interni

`env` e `runs` sono comandi interni di assistenza ed esame degli elementi. Preferisci i flussi di lavoro pubblici basati su ID attività, ID lotto, `local` e `data`, a meno che l'assistenza Octoparse non fornisca indicazioni diverse.

<Tip>
  Esegui `octoparse <command> --help` per la versione installata e usa `octoparse capabilities --json` per i metadati di automazione.
</Tip>
