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

> Erstellen, starten, verwalten, planen, prüfen, automatisieren und exportieren Sie Octoparse-Aufgaben mit der CLI lokal oder in der Cloud.

Octoparse CLI ist ein Befehlszeilentool, mit dem Sie Octoparse-Aufgaben über ein Terminal erstellen, ausführen, verwalten, planen, prüfen und exportieren können.

Anders als die Desktop-App ist Octoparse CLI für skriptgesteuerte Workflows, CI/CD-Pipelines, Serverumgebungen und automatisierte Datenpipelines ausgelegt.

## Funktionen von Octoparse CLI

<CardGroup cols={2}>
  <Card title="Aufgaben aus einer URL erstellen" icon="wand-magic-sparkles" href="./cli/guides/detect">
    Untersuchen Sie eine beliebige URL und erstellen Sie automatisch, manuell oder über einen KI-Agenten-Workflow eine lokale Aufgabendatei.
  </Card>

  <Card title="Aufgaben finden und verwalten" icon="magnifying-glass" href="./cli/guides/tasks-and-groups">
    Listen Sie Cloud-Aufgaben auf, suchen Sie nach Stichwörtern, prüfen Sie Aufgabendetails und arbeiten Sie mit Aufgabengruppen.
  </Card>

  <Card title="Aus Vorlagen erstellen" icon="table-cells" href="./cli/guides/templates">
    Zeigen Sie Vorlagen an, suchen Sie darin und erstellen oder ändern Sie Vorlagenaufgaben.
  </Card>

  <Card title="Aufgaben lokal ausführen" icon="play" href="./cli/guides/local-runs">
    Führen Sie Octoparse-Aufgaben mit der integrierten lokalen Engine und unabhängigem Chrome aus.
  </Card>

  <Card title="Browsermodus auswählen" icon="window" href="./cli/guides/browser-modes">
    Verwenden Sie unabhängiges Chrome oder nutzen Sie ein angemeldetes Chrome- oder Edge-Profil erneut.
  </Card>

  <Card title="Cloud-Aufgaben ausführen und planen" icon="calendar" href="./cli/guides/cloud-runs-and-schedules">
    Starten Sie die Cloud-Extraktion, prüfen Sie den Verlauf und konfigurieren Sie wiederkehrende Zeitpläne.
  </Card>

  <Card title="Daten prüfen und exportieren" icon="file-export" href="./cli/guides/data">
    Prüfen Sie Datensatzanzahlen, zeigen Sie Zeilen in der Vorschau an, kontrollieren Sie nicht exportierte Daten und exportieren Sie lokale oder Cloud-Ergebnisse.
  </Card>

  <Card title="Mit Agenten automatisieren" icon="robot" href="./cli/guides/automation">
    Integrieren Sie die CLI mithilfe von JSON-Ausgaben, JSONL-Ereignisstreams und Exit-Codes in Skripte und KI-Agenten.
  </Card>
</CardGroup>

## Funktionsweise

Octoparse CLI führt die integrierte Octoparse-Engine für die lokale Extraktion direkt aus. Sie verwendet unabhängiges Chrome und benötigt den Electron-Desktop-Client nicht.

Die Cloud-Extraktion wird über Backend-APIs gesteuert. Die lokale Extraktion wird von der lokalen Engine gesteuert.

<Note>
  Der Status lokaler Läufe wird von dieser CLI verfolgt und nicht mit dem Status des Octoparse-Desktop-Clients synchronisiert.
</Note>

## Anforderungen

Stellen Sie vor der Verwendung von Octoparse CLI Folgendes sicher:

* Node.js 20 oder neuer
* npm 8 oder neuer
* Ein Octoparse-Konto (API-Schlüssel oder OAuth)
* Zugriff auf die Aufgaben, die Sie ausführen oder exportieren möchten

Unter [Installation](./cli/quick-start/installation) finden Sie Plattformanforderungen und Einrichtungsschritte einschließlich der Einschränkungen für Linux arm64.

Funktionale Befehle erfordern eine Authentifizierung, auch lokale Läufe mit `--task-file` und `.otd`. Einrichtungs- und Diagnosebefehle wie `--help`, `--version`, `doctor`, `browser`, `capabilities` und `auth` können ohne Authentifizierung ausgeführt werden.

## Typischer Workflow

<Steps>
  <Step title="Octoparse CLI installieren">
    Installieren Sie die CLI global mit npm.
  </Step>

  <Step title="Authentifizieren">
    Loggen Sie sich über OAuth oder mit einem Octoparse-API-Schlüssel ein. Verwenden Sie für CI die Umgebungsvariable `OCTO_ENGINE_API_KEY`.

    <Warning>
      Übernehmen Sie API-Schlüssel nicht in Git, Skripte, Dokumente, Screenshots, geteilte Protokolle oder CI-Ausgaben.
    </Warning>
  </Step>

  <Step title="Aufgabe erstellen oder finden">
    Erstellen Sie mit `octoparse detect <url>` eine Aufgabendatei aus einer URL, erstellen Sie eine Aufgabe aus einer Vorlage oder suchen Sie mit `octoparse task list` nach einer vorhandenen Aufgaben-ID.
  </Step>

  <Step title="Aufgabe ausführen oder steuern">
    Führen Sie die Aufgabe lokal aus, starten oder stoppen Sie einen Cloud-Lauf, konfigurieren Sie einen Cloud-Zeitplan oder prüfen Sie den Laufstatus.
  </Step>

  <Step title="Daten prüfen und exportieren">
    Prüfen Sie den Datenstatus, zeigen Sie Zeilen in der Vorschau an, kontrollieren Sie nicht exportierte Daten oder exportieren Sie erfasste Daten aus lokalen oder Cloud-Ergebnissen.
  </Step>
</Steps>

## Häufige Befehlsbeispiele

Ersetzen Sie `<taskId>` durch Ihre tatsächliche Aufgaben-ID und `<url>` durch die Seite, die Sie scrapen möchten.

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

## Derzeitige Einschränkungen

Octoparse CLI v1 unterstützt weder Kernel-Browser noch veraltete Workflows.

Kernel-Browser bezeichnet den Browsermodus älterer Octoparse-Laufzeit-Workflows. Veraltete Workflows sind Aufgaben, die mit älteren Octoparse-Aufgabendefinitionen erstellt wurden und von der aktuellen CLI-Laufzeit nicht unterstützt werden.

Wenn eine Aufgabe nicht unterstützt wird, erstellen oder aktualisieren Sie sie in der aktuellen Octoparse-Desktop-App und führen Sie sie anschließend erneut mit der CLI aus.

## Nächste Schritte

<CardGroup cols={3}>
  <Card title="Octoparse CLI installieren" icon="download" href="./cli/quick-start/installation">
    Richten Sie Node.js ein, installieren Sie die CLI mit npm und überprüfen Sie die lokale Laufzeit.
  </Card>

  <Card title="Aufgaben aus einer URL erstellen" icon="wand-magic-sparkles" href="./cli/guides/detect">
    Erstellen Sie mit detect eine Aufgabendatei aus einer beliebigen URL.
  </Card>

  <Card title="Alle Befehle durchsuchen" icon="list-check" href="./cli/reference/command-cheatsheet">
    Informieren Sie sich über Aufgaben-, Vorlagen-, Zeitplan-, detect-, lokale Lauf-, Cloud-Lauf-, Authentifizierungs- und Exportbefehle.
  </Card>
</CardGroup>