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

> Nutzen Sie Octoparse CLI in CI, Skripten und KI-Agenten mit Funktionserkennung, JSON-Ausgabe, Umgebungsvariablen und Exit-Codes.

Verwenden Sie maschinenlesbare Ausgaben und die Funktionserkennung, anstatt in Skripten oder Agenten-Workflows für Menschen bestimmte Hilfetexte auszuwerten.

## Aktuellen Funktionsumfang ermitteln

```bash theme={null}
octoparse capabilities --json
```

Die Antwort beschreibt unterstützte Befehle, Authentifizierung, Browsermodi, Ausgabeschemas, Lebenszyklusereignisse und empfohlene Rezepte für Agenten.

Agenten sollten den Vertrag zu Beginn eines Workflows prüfen, anstatt Annahmen über Flags oder JSON-Felder fest zu codieren.

## In CI authentifizieren

```bash theme={null}
OCTO_ENGINE_API_KEY=xxx octoparse task list --json
OCTO_ENGINE_ACCESS_TOKEN=xxx octoparse task list --json
```

Die Priorität der Anmeldedaten lautet: Zugriffstoken, API-Schlüssel und anschließend die mit `octoparse auth login` gespeicherten Anmeldedaten.

<Warning>
  Drucken Sie Anmeldedaten nicht aus und nehmen Sie sie weder in Commits noch in geteilte Protokolle, Screenshots oder generierte Dokumentation auf.
</Warning>

## Ausgabemodus auswählen

```bash theme={null}
octoparse task list --json
octoparse run <taskId> --json
octoparse run <taskId> --jsonl
```

* `--json` gibt einen einzelnen Ergebnis-Umschlag zurück.
* `--jsonl` streamt Ereignisse eines im Vordergrund ausgeführten Laufs als JSON Lines.
* Die lesbare Ausgabe ist für die interaktive Verwendung im Terminal bestimmt.

Unter [Ausgabe und Exit-Codes](../reference/output-and-exit-codes) finden Sie Schemas, Lebenszyklusereignisse, das Verhalten von stdout/stderr und Fehlercodes.

## Aufgaben mit einem Agenten erstellen

Agenten sollten `detect --agent` oder den Workflow „Vorbereiten/Vorschau/Anwenden“ verwenden, nicht `--auto`.

```bash theme={null}
octoparse detect <url> \
  --agent \
  --agent-command "path/to/trusted-agent" \
  --goal "Extract product titles and prices" \
  --run-sample 5 \
  --json
```

Folgen Sie `machineContract.recipes.createTaskFromUrlWithAgent` aus der Antwort des capabilities-Befehls. Übergeben Sie an `--agent-command` nur eine vertrauenswürdige ausführbare Datei.

## Zustandsändernde Befehle bestätigen

Befehle, die Zeitpläne umbenennen, verschieben, löschen, aktualisieren oder ändern, erfordern möglicherweise `--yes`. Ermitteln Sie die Bestätigungsanforderungen mit `capabilities --json`, bevor Sie eine Automatisierung erstellen.

## Interne Befehle

`env` wechselt zwischen internen API-Umgebungen und `runs` untersucht interne lokale Artefakte. Sie gehören nicht zum primären Benutzer-Workflow. Bevorzugen Sie öffentliche Befehle mit Aufgaben- und Lauf-IDs, sofern der Octoparse-Support Sie nicht anders anweist.