cw-import-CLI: automatisierte Importe

Integrator

Ziel

Größere oder wiederkehrende Importe ohne die interaktive Import-Seite abwickeln – per Skript oder Zeitplan (cron/launchd/Aufgabenplanung). Die interaktive Variante beschreibt Ein Dokument importieren; fachlich dahinter steht Import.

Was es ist

cw-import ist ein eigenständiges Kommandozeilen-Werkzeug (Python, als Binär für macOS/Windows gebaut). Es durchläuft dieselbe Pipeline wie die UI: Ingest → Convert → Fix → Enrich → Validate → Publish und schreibt fertige Markdown-Artikel mit Frontmatter und Bild-Assets in die Wissensbasis-Ablage.

Wichtige Befehle

cw-import process <Pfade/URLs…> – komplette Pipeline für Dateien, Ordner oder URLs (Optionen: --recursive, --force, --enrich).
cw-import confluence --space <KEY> – einen Confluence-Space spiegeln (--dry-run, --enrich, --rewrite-links).
cw-import sharepoint crawl – eine SharePoint-Online-Seite spiegeln (--site, --report).
cw-import status [doc-id] · retry doc-id · reject doc-id – Stand prüfen / erneut versuchen / verwerfen.
cw-import config init|show|validate – Konfiguration anlegen/prüfen.

Einzelne Phasen lassen sich auch getrennt ausführen (ingest/convert/fix/enrich/validate/publish).

Konfiguration & Secrets

Konfigdatei in dieser Reihenfolge: --config, Umgebungsvariable CW_IMPORT_CONFIG, ./cw-import.yaml, ~/.cw-import/config.yaml. Zugangsdaten kommen aus der Umgebung (.env), u. a. MISTRAL_API_KEY (OCR), OPENAI_API_KEY (Anreicherung), CONFLUENCE_PASSWORD, SHAREPOINT_TENANT_ID/CLIENT_ID/CLIENT_SECRET. → Umgebungsvariablen & appsettings

Zeitplanung

Einen eigenen Scheduler bringt das Werkzeug nicht mit – nutzen Sie das Betriebssystem:

Linux/macOS (cron): 0 2 * * * cd /pfad/cw-import && cw-import confluence --space HOWTO --enrich
macOS (launchd): LaunchAgent-Plist mit demselben Aufruf.
Windows (Aufgabenplanung): schtasks /create /tn "CW Import" /tr "cw-import.exe confluence --space HOWTO" /sc daily /st 02:00

Verifikation

cw-import status zeigt veröffentlichte Dokumente; in der App erscheinen die Artikel in der Zielwissensbasis.
--dry-run (Confluence/SharePoint) listet Treffer, ohne zu schreiben – ideal zum Testen.

Troubleshooting

OCR/Anreicherung schlägt fehl – fehlender/ungültiger MISTRAL_API_KEY bzw. OPENAI_API_KEY.
Doppelte Importe – ohne --force werden bereits veröffentlichte Dokumente übersprungen.
Confluence/SharePoint leer – Space-Key/Site und Zugangsdaten prüfen; mit --dry-run gegenprüfen.