Ligne de commande
Tout depuis le terminal avec npx argorant. Une sortie JSON pour les scripts et les agents, des pages avec un curseur, des nouvelles tentatives sans risque et des codes de sortie exploitables.
npx argorant login # paste a key from app.argorant.com/profile once
npx argorant account # plan, credits, request limit, campaign emailsnpx l'exécute sans installation. Pour l'installer durablement, lancez npm install -g argorant. L'outil lit la clé depuis argorant login ou depuis la variable ARGORANT_API_KEY.
Commandes
| Commande | Ce qu'elle fait |
|---|---|
account | Forfait, crédits, limite de requêtes et e-mails de campagne |
count "<words>" [filters] | Compte les personnes correspondantes, gratuit |
search "<words>" -n 10 | Un aperçu masqué, gratuit |
company <domain> | Combien de personnes dans une entreprise, gratuit |
companies count / search / people | Les entreprises qui correspondent à vos filtres, gratuit |
lookup industries / countries / keywords / technologies / titles [text] | Les noms exacts à utiliser dans les filtres, gratuit |
filters | Chaque filtre de recherche avec ses options et ses valeurs, et ceux qui sont déjà disponibles, gratuit |
reveal "<words>" -n 25 | Les informations complètes avec des e-mails vérifiés, consomme des crédits |
enrich --email a@b.com / --name "..." --domain d / --domain d | Complète une fiche |
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100 | Trouve des e-mails professionnels : 1 crédit si trouvé, 0,25 si rien n'est trouvé |
find status / download / resume / cancel <job_id>, find pricing | Les listes et les prix de la recherche d'e-mails |
lists ls / create / show / people / rename / rm / export | Listes enregistrées |
lists remove-people <id> --title Intern --preview / --ids a,b | Retire des personnes d'une liste enregistrée. La commande compte d'abord et demande ; --preview se contente de compter. Ajouter de nouveau la même recherche les laisse de côté |
export "<words>" -n 1000 -o leads.csv | Un CSV de contacts vérifiés, consomme des crédits |
exports ls / status / download | Vos exports |
verify <email> / verify --file emails.csv -o checked.csv | Vérifie des e-mails que vous avez déjà |
campaigns list / create / update / status / delete | Les campagnes et leurs paramètres |
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bounces | Garde les adresses qui ont rebondi chez d'autres utilisateurs d'Argorant, ou les laisse de côté (par défaut) |
campaigns emails set <c> --step 1 --subject ... --body-file f | Les e-mails |
campaigns leads add <c> --list <id> / leads list / leads remove | Les personnes d'une campagne |
campaigns leads add <c> --list <id> --grades valid | La réponse quand un ajout demande quelles adresses ajouter. valid (recommandé) n'ajoute que les adresses valides, valid,catch_all ajoute aussi les catch-all |
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c> | Retire beaucoup de personnes d'un coup, avec un aperçu d'abord ; suit les ajouts et retraits importants |
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag> | Ajoute un tag à des personnes, puis les retire, les réintègre, les déplace ou les liste par tag |
campaigns leads restore <c> --tag <tag> / --all-removed | Réintègre des personnes retirées qui n'ont jamais reçu d'e-mail, avec un aperçu d'abord |
campaigns leads move <c> --to <c2> --tag <tag> | Déplace des personnes vers une autre campagne avec leurs propres champs, avec un aperçu d'abord |
campaigns personalize import <c> lines.csv | Les phrases personnalisées de nombreuses personnes depuis un seul fichier |
campaigns test <c> --step 1 | Un e-mail de test pour vous, n'ajoute personne |
campaigns folders / folders create --name / move <c> --folder <f> | Les dossiers de campagnes |
campaigns list --folder <f> / --no-folder | Les campagnes d'un dossier, ou celles qui ne sont dans aucun dossier |
campaigns senders set <c> --all / senders list / senders remove | Les boîtes mail d'envoi |
campaigns launch / pause / stop <c> | Démarre ou arrête l'envoi ; le lancement demande d'abord, -y saute la question |
campaigns analytics <c> --days 30 / campaigns replies <c> | Les résultats et les réponses d'une campagne |
inbox list / read / reply / forward / classify | Toutes les réponses au même endroit |
inbox stages / stages add / set / rm | Les étapes de votre pipeline pour les réponses |
inboxes list --status needs_attention --tag t / set / disconnect / connect-google | Vos boîtes mail |
inboxes update --domains a.com --daily-limit 30 | Modifie de nombreuses boîtes mail d'un coup, avec un aperçu d'abord |
inboxes set <mailbox> --name "Elena Vaughn" | Le nom d'expéditeur que les destinataires voient, une boîte mail à la fois |
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push" | Les tags des boîtes mail avec leur nombre, des tags pour de nombreuses boîtes mail d'un coup (avec un aperçu d'abord), et les tags d'une commande, qui s'appliquent aussi aux boîtes mail qu'elle crée plus tard (guide) |
inboxes test-smtp / connect-smtp / connect-smtp --csv / presets | Des boîtes mail de n'importe quel fournisseur (guide) ; le mot de passe est demandé ou lu dans une variable d'environnement, jamais sur la ligne de commande |
inboxes quote / order / status / renewal | De nouvelles boîtes mail sur de nouveaux domaines |
blocklist list / add / remove / job | Les adresses et domaines jamais contactés. list en affiche 50 à la fois (--all, --search, --campaign) ; add et remove acceptent plusieurs valeurs ou --file list.csv (par appels de 5 000), --campaign pour certaines campagnes seulement et --dry-run |
webhooks ls / add / set / test / deliveries / rm | Des événements envoyés à votre serveur, à partir du forfait Pro |
Filtres
Chaque commande de recherche (count, search, reveal, export, lists create, l'ajout à une liste, companies) accepte les mêmes filtres que l'app, l'API et le connecteur Claude. Avec une virgule, n'importe laquelle des valeurs suffit. Chaque filtre de liste a un jumeau d'exclusion qui retire toutes les personnes que le filtre d'inclusion trouverait pour les mêmes valeurs, et les deux peuvent s'utiliser ensemble.
| Inclure | Exclure | Ce qu'il cible |
|---|---|---|
--title | --exclude-title | Intitulés de poste ; les formes courtes fonctionnent dans les deux sens (CFO, Chief Financial Officer) |
--keywords | --exclude-keywords | Des mots qui décrivent ce que fait l'entreprise, comme fintech (--keyword-scope people pour les compétences des personnes elles-mêmes) |
--industry | --exclude-industry | Secteurs en mots simples |
--country | --exclude-country | Pays ou régions comme DACH, Nordics, APAC |
--state | --exclude-state | États ou provinces, par nom ou par code |
--city | --exclude-city | Villes |
--seniority | --exclude-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales, Marketing, Engineering, Finance et les autres départements |
--domain | --exclude-domain | Sites web d'entreprise, comme stripe.com |
Comment les mots correspondent :
--title-match words(par défaut) exige chaque mot en tant que mot entier, donc Data ne correspond pas à Database.exactexige l'intitulé de poste complet, donc CEO ne correspond pas à Founder & CEO.containstrouve le texte n'importe où, y compris à l'intérieur d'un mot.- Par défaut, les mots-clés portent sur ce que fait l'entreprise (son nom, ses tags, son secteur et sa description).
--keyword-scope peopleporte sur les compétences et les profils des personnes elles-mêmes, etanysur les deux plus les intitulés de poste. --industry-match primaryne correspond qu'au secteur principal de l'entreprise, donc Software laisse de côté un commerçant ou une banque qui porte aussi un tag logiciel.any(par défaut) correspond à n'importe lequel de ses secteurs.--country-match person(par défaut) retient le lieu où la personne est basée et laisse de côté les personnes dont le lieu n'est pas connu.person_or_companyutilise pour elles le pays de l'entreprise.
Il existe d'autres filtres, comme --employees 51-200, --employees-min et --employees-max, --revenue 10m-50m, --revenue-min et --revenue-max, --company (plusieurs entreprises : séparez les noms par |), --has-phone et --has-linkedin. npx argorant filters liste tous les filtres disponibles.
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.csvUne liste enregistrée se remplit en arrière-plan. lists show <id> indique si elle est encore en cours de remplissage ; un ajout à une liste en cours de remplissage attend son tour.
Conçu pour les scripts et les agents
--jsonsur n'importe quelle commande affiche la réponse de l'API telle quelle.- Les listes affichent un curseur sous chaque page. Passez-le avec
--cursor, ou ajoutez--allpour lire toutes les pages. - Chaque écriture reçoit une nouvelle
Idempotency-Key. Passez--idempotency-key <key>pour choisir la vôtre : relancer la même commande renvoie alors la première réponse au lieu de faire le travail deux fois. - Les codes de sortie sont
0en cas de succès,1en cas d'erreur (et pourfindsans résultat),2pour une clé manquante ou incorrecte,3pour un scope manquant,4pour une limite de débit ou une limite quotidienne,5quand un forfait ou plus de crédits sont nécessaires, et6quand un choix est d'abord nécessaire et que rien n'a été modifié (campaigns leads adddemande quels types d'adresses ajouter). - Les commandes qui modifient de nombreuses personnes ou boîtes mail (
leads remove,leads restore,leads move,lists remove-people,inboxes tag,inboxes update) comptent d'abord, puis demandent.--previewse contente de compter, et--yessaute la question. - Les erreurs affichent le code, le message en clair et l'identifiant de la requête.
- Les commandes qui consomment des crédits demandent d'abord dans un terminal. Elles ne demandent rien quand la sortie n'est pas un terminal, ni avec
--yesou--json: vérifiez donc votre-ndans les scripts. - Une campagne peut être désignée par son identifiant ou par le début de son nom.
De la recherche à une campagne en cours
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
# when the list also holds catch-all or unchecked addresses, it asks first and adds nothing (exit code 6):
npx argorant campaigns leads add "UK finance" --list 1240 --grades valid
# business emails only: add --exclude-private-emails (free mail and home internet addresses are left out)
npx argorant campaigns senders set "UK finance" --all
npx argorant campaigns launch "UK finance"Envoyer des personnes vers vos autres outils
Envoyez un export dans l'outil d'envoi que vous utilisez déjà, dans votre propre compte. Une liste part sous forme d'export. Inclus à partir du forfait Pro.
Intégrations
Envoyez les personnes que vous trouvez dans Argorant vers les outils que vous utilisez déjà, ou appelez Argorant depuis vos propres automatisations.