ArgorantDocs

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.

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

npx 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

CommandeCe qu'elle fait
accountForfait, crédits, limite de requêtes et e-mails de campagne
count "<words>" [filters]Compte les personnes correspondantes, gratuit
search "<words>" -n 10Un aperçu masqué, gratuit
company <domain>Combien de personnes dans une entreprise, gratuit
companies count / search / peopleLes entreprises qui correspondent à vos filtres, gratuit
lookup industries / countries / keywords / technologies / titles [text]Les noms exacts à utiliser dans les filtres, gratuit
filtersChaque filtre de recherche avec ses options et ses valeurs, et ceux qui sont déjà disponibles, gratuit
reveal "<words>" -n 25Les informations complètes avec des e-mails vérifiés, consomme des crédits
enrich --email a@b.com / --name "..." --domain d / --domain dComplète une fiche
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100Trouve des e-mails professionnels : 1 crédit si trouvé, 0,25 si rien n'est trouvé
find status / download / resume / cancel <job_id>, find pricingLes listes et les prix de la recherche d'e-mails
lists ls / create / show / people / rename / rm / exportListes enregistrées
lists remove-people <id> --title Intern --preview / --ids a,bRetire 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.csvUn CSV de contacts vérifiés, consomme des crédits
exports ls / status / downloadVos exports
verify <email> / verify --file emails.csv -o checked.csvVérifie des e-mails que vous avez déjà
campaigns list / create / update / status / deleteLes campagnes et leurs paramètres
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bouncesGarde 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 fLes e-mails
campaigns leads add <c> --list <id> / leads list / leads removeLes personnes d'une campagne
campaigns leads add <c> --list <id> --grades validLa 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-removedRé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.csvLes phrases personnalisées de nombreuses personnes depuis un seul fichier
campaigns test <c> --step 1Un 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-folderLes campagnes d'un dossier, ou celles qui ne sont dans aucun dossier
campaigns senders set <c> --all / senders list / senders removeLes 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 / classifyToutes les réponses au même endroit
inbox stages / stages add / set / rmLes étapes de votre pipeline pour les réponses
inboxes list --status needs_attention --tag t / set / disconnect / connect-googleVos boîtes mail
inboxes update --domains a.com --daily-limit 30Modifie 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 / presetsDes 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 / renewalDe nouvelles boîtes mail sur de nouveaux domaines
blocklist list / add / remove / jobLes 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 / rmDes é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.

InclureExclureCe qu'il cible
--title--exclude-titleIntitulés de poste ; les formes courtes fonctionnent dans les deux sens (CFO, Chief Financial Officer)
--keywords--exclude-keywordsDes 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-industrySecteurs en mots simples
--country--exclude-countryPays ou régions comme DACH, Nordics, APAC
--state--exclude-stateÉtats ou provinces, par nom ou par code
--city--exclude-cityVilles
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales, Marketing, Engineering, Finance et les autres départements
--domain--exclude-domainSites 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. exact exige l'intitulé de poste complet, donc CEO ne correspond pas à Founder & CEO. contains trouve 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 people porte sur les compétences et les profils des personnes elles-mêmes, et any sur les deux plus les intitulés de poste.
  • --industry-match primary ne 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_company utilise 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.

Shell
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

Une 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

  • --json sur 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 --all pour 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 0 en cas de succès, 1 en cas d'erreur (et pour find sans résultat), 2 pour une clé manquante ou incorrecte, 3 pour un scope manquant, 4 pour une limite de débit ou une limite quotidienne, 5 quand un forfait ou plus de crédits sont nécessaires, et 6 quand un choix est d'abord nécessaire et que rien n'a été modifié (campaigns leads add demande 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. --preview se contente de compter, et --yes saute 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 --yes ou --json : vérifiez donc votre -n dans 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

Shell
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"

Sur cette page