Kommandozeile

npx argorant login           # paste a key from app.argorant.com/profile once
npx argorant account         # plan, credits, request limit, campaign emails

npx startet das Tool ohne Installation. Um es dauerhaft zu installieren, führ npm install -g argorant aus. Das Tool liest den Schlüssel aus argorant login oder aus der Variable ARGORANT_API_KEY.

Befehle

Filter

Jeder Suchbefehl (count, search, reveal, export, lists create, Hinzufügen zu einer Liste, companies) nimmt dieselben Filter wie die App, die API und der Claude-Connector. Ein Komma heißt: einer davon. Jeder Listenfilter hat ein Gegenstück zum Ausschließen, das alle entfernt, die der einschließende Filter für dieselben Werte finden würde. Beide lassen sich zusammen nutzen.

Die Werte sind englisch, also Germany statt Deutschland.

So werden Wörter abgeglichen:

• --title-match words (Standard) verlangt jedes Wort als ganzes Wort, Data passt also nicht auf Database. exact verlangt den ganzen Jobtitel, CEO passt also nicht auf Founder & CEO. contains findet den Text überall, auch mitten im Wort.
• Stichwörter suchen standardmäßig überall: was die Firma macht, Fähigkeiten und Profile der Personen, Jobtitel und Firmennamen. --keyword-scope company sucht nur in dem, was die Firma macht (Tags, Branche und Beschreibung).

Es gibt noch mehr Filter, etwa --employees 51-200, --employees-min und --employees-max, --revenue 10m-50m, --revenue-min und --revenue-max, --company (mehrere Firmen: Namen mit | verbinden), --has-phone und --has-linkedin. npx argorant filters zeigt alle Filter, die du nutzen kannst.

npx argorant count --title "VP Sales" --title-match exact --country DACH --exclude-country Switzerland
npx argorant export --keywords fintech --exclude-keywords "venture capital, private equity" -n 500 -o fintech.csv

Eine gespeicherte Liste füllt sich im Hintergrund. lists show <id> sagt, ob sie sich noch füllt. Wenn du zu einer Liste hinzufügst, die sich noch füllt, wartet das, bis es an der Reihe ist.

Gemacht für Skripte und Agenten

• --json gibt bei jedem Befehl die Antwort der API unverändert aus.
• Listen geben unter jeder Seite einen Cursor aus. Gib ihn mit --cursor mit oder hänge --all an, um alle Seiten zu lesen.
• Jeder schreibende Befehl bekommt einen neuen Idempotency-Key. Mit --idempotency-key <key> wählst du deinen eigenen. Wenn du denselben Befehl erneut ausführst, kommt dann die erste Antwort zurück, statt dass die Arbeit doppelt gemacht wird.
• Exit-Codes sind 0 für Erfolg, 1 für einen Fehler (und für find ohne Ergebnis), 2 für einen fehlenden oder falschen Schlüssel, 3 für einen fehlenden Scope, 4 für ein Anfrage- oder Tageslimit und 5, wenn ein Plan oder mehr Credits nötig sind.
• Fehler geben den Code, die Meldung und die Request-ID aus.
• Befehle, die Credits kosten, fragen im Terminal zuerst nach. Sie fragen nicht, wenn die Ausgabe kein Terminal ist oder mit --yes oder --json. Prüf in Skripten also dein -n.
• Eine Kampagne kannst du über ihre ID oder über den Anfang ihres Namens ansprechen.

Von der Suche zur laufenden Kampagne

npx argorant lists create --name "UK finance leaders" --title "CFO, Finance Director" --country "United Kingdom"
npx argorant campaigns create --name "UK finance Q4" --daily-limit 40 --timezone Europe/London
npx argorant campaigns emails set "UK finance" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
npx argorant campaigns leads add "UK finance" --list 1240
# nur geschäftliche E-Mails: --exclude-private-emails (Freemail und private Internetanschlüsse bleiben draußen)
npx argorant campaigns senders set "UK finance" --all
npx argorant campaigns launch "UK finance"