Zum Hauptinhalt springen
Die Octoparse CLI unterstützt menschenlesbare Ausgaben für das Terminal und maschinenlesbare Ausgaben für Automatisierungen. Verwenden Sie diese Seite, wenn Sie die Octoparse CLI aus Skripten, Agenten, CI-Jobs oder anderen Automatisierungsumgebungen aufrufen.

JSON-Ausgabe

Verwenden Sie --json, wenn Sie eine einzelne stabile JSON-Antwort benötigen.
Erfolgreiche Befehle geben einen JSON-Umschlag mit ok: true und einem data-Feld zurück:
Fehlgeschlagene Befehle geben ok: false mit einem error-Feld zurück, das einen Code und eine Meldung enthält:
Die genaue data-Struktur hängt vom Befehl ab. Zu den häufigen Fehlercodes gehören AUTH_REQUIRED, AUTH_INVALID, TASK_INVALID, LINUX_ARM64_UNSUPPORTED, ENGINE_RUN_FAILED und UNSUPPORTED_EXPORT_FORMAT. Führen Sie octoparse capabilities --json aus, um die vollständige Liste anzuzeigen.

JSONL-Ereignisströme

Verwenden Sie --jsonl für lang laufende lokale Extraktionen. Die Ausgabe enthält pro Zeile ein JSON-Objekt:
Ein typischer Ereignisstrom:
Stabile Ereignistypen:
Ereignisnamen und Felder können sich zwischen Versionen ändern. Behandeln Sie jede Zeile als eigenständiges JSON-Objekt und verarbeiten Sie unbekannte Felder sicher.

Artefakte losgelöster Läufe

Wenn Sie einen Lauf mit --detach starten, schreibt die CLI Startdateien in das Ausgabeverzeichnis: Artefaktdateien eines lokalen Laufs im Laufverzeichnis:

stdout und stderr

Durch diese Trennung können Automatisierungstools angeforderte Ausgaben weiterleiten, ohne Diagnoseprotokolle beizumischen.

Exit-Codes

Ein Exit-Code ungleich null bedeutet, dass der Befehl nicht wie erwartet abgeschlossen wurde.

Empfehlungen für die Automatisierung

  • Verwenden Sie --json für Skripte, die eine einzelne strukturierte Antwort benötigen.
  • Verwenden Sie --jsonl für lang laufende Aufgabenausführungen.
  • Behandeln Sie Exit-Codes ungleich null als fehlgeschlagene Automatisierungsschritte.
  • Erfassen Sie stderr bei der Fehlerbehebung separat.
  • Geben Sie API-Schlüssel oder Token nicht in Protokollen oder CI-Ausgaben preis.
  • Führen Sie zu Beginn eines Agenten-Workflows octoparse capabilities --json aus, um die aktuelle Befehlsoberfläche und den Maschinenvertrag zu ermitteln.
Bevorzugen Sie für KI-Agenten und Automatisierungsumgebungen --json oder --jsonl gegenüber menschenlesbaren Ausgaben. Beginnen Sie mit octoparse capabilities --json, um den vollständigen Maschinenvertrag abzurufen.