Kommandozeile
Alles aus dem Terminal mit npx argorant: JSON für Skripte und Agenten, Seiten mit Cursor, sichere Wiederholungen und Exit-Codes zum Reagieren.
npx argorant login # paste a key from app.argorant.com/profile once
npx argorant account # plan, credits, request limit, campaign emailsnpx 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
| Befehl | Was er tut |
|---|---|
account | Plan, Credits, Anfragelimit und Kampagnen-E-Mails |
count "<words>" [filters] | Passende Personen zählen, kostenlos |
search "<words>" -n 10 | Eine maskierte Vorschau, kostenlos |
company <domain> | Wie viele Personen in einer Firma, kostenlos |
companies count / search / people | Firmen, die zu deinen Filtern passen, kostenlos |
lookup industries / countries / keywords / technologies / titles [text] | Die genauen Namen zum Filtern, kostenlos |
filters | Jeder Suchfilter mit seinen Flags und Werten und welche schon bereit sind, kostenlos |
reveal "<words>" -n 25 | Vollständige Daten mit geprüften E-Mails, kostet Credits |
enrich --email a@b.com / --name "..." --domain d / --domain d | Einen Datensatz ergänzen |
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100 | Geschäftliche E-Mails finden: 1 Credit, wenn gefunden, 0,25, wenn nichts gefunden wird |
find status / download / resume / cancel <job_id>, find pricing | Listen und Preise des E-Mail-Finders |
lists ls / create / show / people / rename / rm / export | Gespeicherte Listen |
lists remove-people <id> --title Intern --preview / --ids a,b | Personen aus einer gespeicherten Liste herausnehmen. Zählt zuerst und fragt dann, --preview zählt nur. Fügst du dieselbe Suche erneut hinzu, bleiben sie draußen |
export "<words>" -n 1000 -o leads.csv | Eine CSV-Datei mit geprüften Kontakten, kostet Credits |
exports ls / status / download | Deine Exporte |
verify <email> / verify --file emails.csv -o checked.csv | E-Mails prüfen, die du schon hast |
campaigns list / create / update / status / delete | Kampagnen und ihre Einstellungen |
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bounces | Adressen behalten, die bei anderen Argorant-Nutzern unzustellbar waren, oder sie weglassen (Standard) |
campaigns emails set <c> --step 1 --subject ... --body-file f | Die E-Mails |
campaigns leads add <c> --list <id> / leads list / leads remove | Die Personen in einer Kampagne |
campaigns leads add <c> --list <id> --grades valid | Die Antwort, wenn das Hinzufügen fragt, welche Adressen hinein sollen. valid (empfohlen) nimmt nur gültige Adressen, valid,catch_all auch Catch-all-Adressen |
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag> | Personen markieren und dann per Tag herausnehmen, zurückholen, verschieben oder auflisten |
campaigns leads restore <c> --tag <tag> / --all-removed | Herausgenommene Personen zurückholen, die nie angeschrieben wurden, zuerst mit Vorschau |
campaigns leads move <c> --to <c2> --tag <tag> | Personen mit ihren eigenen Feldern in eine andere Kampagne verschieben, zuerst mit Vorschau |
campaigns folders / folders create --name / move <c> --folder <f> | Ordner für Kampagnen |
campaigns list --folder <f> / --no-folder | Die Kampagnen eines Ordners oder die ohne Ordner |
campaigns senders set <c> --all / senders remove | Die versendenden Postfächer |
campaigns launch / pause / stop <c> | Versand starten oder stoppen. Beim Start wird zuerst gefragt, -y überspringt die Frage |
campaigns analytics <c> --days 30 / campaigns replies <c> | Ergebnisse und Antworten einer Kampagne |
inbox list / read / reply / forward / classify | Jede Antwort an einem Ort |
inboxes list / set / disconnect / connect-google | Deine Postfächer |
inboxes set <mailbox> --name "Elena Vaughn" | Der Absendername, den Empfänger sehen, für jeweils ein Postfach |
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push" | Postfach-Tags mit ihrer Anzahl, Tags für viele Postfächer auf einmal (zuerst mit Vorschau) und die Tags einer Bestellung, die auch an Postfächer gehen, die sie später anlegt (Anleitung) |
inboxes test-smtp / connect-smtp / connect-smtp --csv / presets | Postfächer von jedem Anbieter (Anleitung). Das Passwort wird abgefragt oder aus einer Umgebungsvariable gelesen, nie von der Kommandozeile |
inboxes quote / order / status / renewal | Neue Postfächer auf neuen Domains |
blocklist list / add / remove / job | Adressen und Domains, die nie kontaktiert werden. list zeigt 50 pro Seite (--all, --search, --campaign); add und remove nehmen viele Werte oder --file liste.csv (Aufrufe zu je 5.000), --campaign für einzelne Kampagnen und --dry-run |
credits packs / quote / buy / purchases | Credit-Pakete kaufen. Fragt zuerst, dann gespeicherte Karte oder Zahlungslink |
webhooks ls / add / set / test / deliveries / rm | Ereignisse an deinen Server, ab dem Plan Pro |
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.
| Einschließen | Ausschließen | Worauf er passt |
|---|---|---|
--title | --exclude-title | Jobtitel. Kurzformen funktionieren in beide Richtungen (CFO, Chief Financial Officer) |
--keywords | --exclude-keywords | Wörter, die beschreiben, was die Firma macht, etwa fintech (--keyword-scope people für eigene Fähigkeiten der Personen) |
--industry | --exclude-industry | Branchen in normalen Worten |
--country | --exclude-country | Länder oder Regionen wie DACH, Nordics, APAC |
--state | --exclude-state | Bundesländer, Staaten oder Provinzen, nach Name oder Kürzel |
--city | --exclude-city | Städte |
--seniority | --exclude-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales, Marketing, Engineering, Finance und die anderen Abteilungen |
--domain | --exclude-domain | Firmen-Websites, etwa stripe.com |
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.exactverlangt den ganzen Jobtitel, CEO passt also nicht auf Founder & CEO.containsfindet den Text überall, auch mitten im Wort.- Stichwörter suchen standardmäßig in dem, was die Firma macht (Name, Tags, Branche und Beschreibung).
--keyword-scope peoplesucht in Fähigkeiten und Profilen der Personen,anyin beidem und zusätzlich in Jobtiteln. --industry-match primarypasst nur auf die Hauptbranche der Firma. Software lässt also einen Händler oder eine Bank weg, die auch ein Software-Tag trägt.any(Standard) passt auf jede ihrer Branchen.--country-match person(Standard) zählt, wo die Person sitzt, und lässt Personen weg, deren eigener Ort nicht bekannt ist.person_or_companynimmt für sie das Land der Firma.
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.csvEine 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
--jsongibt bei jedem Befehl die Antwort der API unverändert aus.- Listen geben unter jeder Seite einen Cursor aus. Gib ihn mit
--cursormit oder hänge--allan, 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
0für Erfolg,1für einen Fehler (und fürfindohne Ergebnis),2für einen fehlenden oder falschen Schlüssel,3für einen fehlenden Scope,4für ein Anfrage- oder Tageslimit,5, wenn ein Plan oder mehr Credits nötig sind, und6, wenn zuerst eine Entscheidung nötig ist und nichts geändert wurde (campaigns leads addfragt, welche Arten von Adressen hinein sollen). - Befehle, die viele Personen oder Postfächer ändern (
leads remove,leads restore,leads move,lists remove-people,inboxes tag,inboxes update), zählen zuerst und fragen dann.--previewzählt nur,--yesüberspringt die Frage. - 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
--yesoder--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
# enthält die Liste auch Catch-all- oder ungeprüfte Adressen, fragt der Befehl zuerst und fügt nichts hinzu (Exit-Code 6):
npx argorant campaigns leads add "UK finance" --list 1240 --grades valid
# 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"Personen an deine anderen Tools senden
Sende einen Export in das Versand-Tool, das du schon nutzt, in dein eigenes Konto dort. Eine Liste geht als ihr Export. Ab dem Pro-Plan enthalten.
Integrationen
Schick die Personen, die du in Argorant findest, an die Tools, die du schon nutzt, oder ruf Argorant aus deinen eigenen Automationen auf.