Die CLI: Installation, Aufbau und Sicherheitsmodell

Was npx argorant ist, wie es sich anmeldet und die eine Regel, die du verinnerlichen solltest.

Die Argorant-CLI ist eine Hülle ohne Abhängigkeiten um dieselbe REST-API, die alles andere auch nutzt. Sie braucht keine Installation:

npx argorant count "fintech CFOs in germany"

Oder installiere sie global mit npm install -g argorant. Das Paket heißt bei npm argorant.

Befehlsgruppen

login, logout, whoami: Anmeldung und Kontostatus
count, search, company: kostenloses Erkunden
list create, list status: gespeicherte Segmente, kostenlos
reveal, export: bezahlte Kontaktdaten
verify: eigene Adressen prüfen
campaigns: nur mit Operator-Keys, eine eigene Schnittstelle

Die eine Regel

reveal, export und verify --file fragen nur dann nach einer Bestätigung, wenn stdin ein Terminal ist und du weder -y noch --json angegeben hast. In CI, in einer Pipe oder in einer Agentenschleife gibt es überhaupt keine Abfrage, und diese Befehle geben sofort aus. Die Abfrage ist eine Bequemlichkeit für Menschen, nie ein Sicherheitsnetz. Prüf dein -n, bevor du sie ausführst.

Terminal, das npx argorant count ausführt und eine Zahl aus dem Bestand ausgibt

Schutzschranken, die immer aktiv sind

Ein nicht numerisches -n bricht ab, statt auf das Standardlimit zurückzufallen.
Ein Flag mit Wert, dem direkt ein anderes Flag folgt, bricht ab, statt es zu verschlucken.
export prüft vor dem Anlegen des Auftrags, ob der Ausgabepfad beschreibbar ist, und gibt einen Befehl zur Wiederherstellung aus, wenn nach der Berechnung etwas scheitert.

Die vollständige CLI-Referenz: argorant.com/docs/cli.