Installation

Octoparse CLI wird als npm-Paket bereitgestellt und läuft mit Node.js 20 oder neuer.

Anforderungen

Stellen Sie vor der Installation von Octoparse CLI sicher, dass Ihre Umgebung Folgendes enthält:

Node.js 20 oder neuer
npm 8 oder neuer
Ein Terminal oder eine Befehlszeilen-Shell

Prüfen Sie Ihre Node.js- und npm-Versionen:

node -v
npm -v

Wenn Ihre Node.js-Version älter als 20 ist, aktualisieren Sie sie, bevor Sie fortfahren.

Node.js herunterladen

Installieren Sie Node.js 20 oder neuer für Ihr Betriebssystem.

Unterstützte Plattformen für die lokale Extraktion

Die lokale Extraktion verwendet eine unabhängige Chrome-Laufzeit. Unterstützte Plattformen:

macOS (x64 und arm64)
Windows (x64)
Linux (x64)

Linux arm64 wird für die lokale Extraktion nicht unterstützt. Chrome for Testing stellt kein Paket für Linux arm64 bereit. Wenn Sie einen ARM-Server oder einen Apple-Silicon-Container mit einem Linux-arm64-Image verwenden, schlagen die lokalen Befehle run und detect fehl. Die Cloud-Extraktion (octoparse cloud start) funktioniert auf jeder Plattform.

Mit npm installieren

Installieren Sie Octoparse CLI global:

npm install -g @octoparse-ai/octoparse-cli

Nach der Installation ist der Befehl octoparse global verfügbar.

Installation überprüfen

Schnellprüfungen

Prüfen Sie die installierte Version:

octoparse --version

Öffnen Sie die Hilfeausgabe:

octoparse --help

Ausgabe von doctor verstehen

Führen Sie die Diagnose aus:

octoparse doctor

octoparse doctor prüft Node.js, die integrierte Octoparse-Engine, Laufzeiterweiterungen, die Verfügbarkeit von Chrome und den Browsermodus. Ein erfolgreiches Ergebnis gibt "ok": true zurück:

{
  "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 – die Octoparse-Desktop-App wird für die Ausführung per CLI nicht benötigt.
browser-mode: independent Chrome only – die lokale Extraktion verwendet eine unabhängige Chrome-Laufzeit und nicht den Browser des Desktop-Clients.

Wenn chrome den Wert ok: false anzeigt, lesen Sie unten den Abschnitt Fehlerbehebung. Verwenden Sie bei Bedarf einen benutzerdefinierten Chrome-Pfad:

octoparse doctor --chrome-path /path/to/chrome

Bereitschaft des Benutzerbrowsers prüfen

octoparse browser status

Verwenden Sie die JSON-Ausgabe für strukturierte Umgebungs- und Benutzerbrowserprüfungen:

octoparse doctor --json
octoparse browser status --json

Installation verwalten

Octoparse CLI aktualisieren

Führen Sie den npm-Installationsbefehl erneut aus, um die CLI zu aktualisieren:

npm install -g @octoparse-ai/octoparse-cli
octoparse --version

Octoparse CLI deinstallieren

npm uninstall -g @octoparse-ai/octoparse-cli

Wenn die Shell octoparse: command not found zurückgibt, wurde der Befehl entfernt.

Fehlerbehebung

Problem	Zu prüfen
`octoparse: command not found`	Stellen Sie sicher, dass sich das globale npm-Binärverzeichnis in Ihrem `PATH` befindet
Berechtigungsfehler bei der Installation	Prüfen Sie die Berechtigungen für globale npm-Pakete oder verwenden Sie einen Node.js-Versionsmanager. npm-Leitfaden ansehen →
Node.js-Version ist zu alt	Aktualisieren Sie auf Node.js 20 oder neuer
npm-Installation überschreitet das Zeitlimit	Prüfen Sie Ihre npm-Registry sowie Proxy-, VPN- oder Firewall-Einstellungen
Chrome kann nicht heruntergeladen werden	Prüfen Sie Ihren Netzwerkzugriff auf das CDN von Chrome for Testing. Versuchen Sie, mit `--chrome-path` ein lokal installiertes Chrome zu verwenden
Linux arm64 wird nicht unterstützt	Verwenden Sie eine Linux-x64-Umgebung oder wechseln Sie mit `octoparse cloud start` zur Cloud-Extraktion
`doctor` zeigt eine fehlgeschlagene Prüfung	Beheben Sie die markierte Abhängigkeit (Node.js, Chrome, Engine-Dateien) und führen Sie `octoparse doctor` erneut aus. Teilen Sie die Ausgabe `ok: false` mit dem Octoparse-Support, falls das Problem fortbesteht

Wie geht es weiter?

API-Schlüssel abrufen und einloggen

Erstellen Sie einen Octoparse-API-Schlüssel und authentifizieren Sie die CLI.

Erste Aufgabe ausführen

Listen und prüfen Sie Aufgaben, führen Sie eine Aufgabe lokal aus und exportieren Sie Daten.

Alle Befehle durchsuchen

Informieren Sie sich über häufige CLI-Befehle für Aufgaben, lokale Läufe, Cloud-Läufe und Exporte.

ÜBERBLICK

ERSTE SCHRITTE

AUFGABEN ERSTELLEN

AUFGABEN UND LÄUFE

DATEN

AUTOMATISIERUNG

REFERENZ

Anforderungen

Node.js herunterladen

Unterstützte Plattformen für die lokale Extraktion

Mit npm installieren

Installation überprüfen

Schnellprüfungen

Ausgabe von doctor verstehen

Bereitschaft des Benutzerbrowsers prüfen

Installation verwalten

Octoparse CLI aktualisieren

Octoparse CLI deinstallieren

Fehlerbehebung

Wie geht es weiter?

API-Schlüssel abrufen und einloggen

Erste Aufgabe ausführen

Alle Befehle durchsuchen

​Anforderungen

Node.js herunterladen

​Unterstützte Plattformen für die lokale Extraktion

​Mit npm installieren

​Installation überprüfen

​Schnellprüfungen

​Ausgabe von doctor verstehen

​Bereitschaft des Benutzerbrowsers prüfen

​Installation verwalten

​Octoparse CLI aktualisieren

​Octoparse CLI deinstallieren

​Fehlerbehebung

​Wie geht es weiter?

API-Schlüssel abrufen und einloggen

Erste Aufgabe ausführen

Alle Befehle durchsuchen

Anforderungen

Unterstützte Plattformen für die lokale Extraktion

Mit npm installieren

Installation überprüfen

Schnellprüfungen

Ausgabe von doctor verstehen

Bereitschaft des Benutzerbrowsers prüfen

Installation verwalten

Octoparse CLI aktualisieren

Octoparse CLI deinstallieren

Fehlerbehebung

Wie geht es weiter?