ArgorantDocs

Riga di comando

Tutto dal terminale con npx argorant. Output JSON per script e agenti, pagine con cursore, ripetizioni sicure e codici di uscita su cui puoi agire.

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

npx lo esegue senza installarlo. Per installarlo in modo permanente, esegui npm install -g argorant. Lo strumento legge la chiave da argorant login o dalla variabile ARGORANT_API_KEY.

Comandi

ComandoCosa fa
accountPiano, crediti, limite di richieste ed email di campagna
count "<words>" [filters]Conta le persone corrispondenti, gratis
search "<words>" -n 10Un'anteprima mascherata, gratis
company <domain>Quante persone ci sono in un'azienda, gratis
companies count / search / peopleLe aziende che corrispondono ai tuoi filtri, gratis
lookup industries / countries / keywords / technologies / titles [text]I nomi esatti da usare nei filtri, gratis
filtersOgni filtro di ricerca con i suoi flag e valori, e quali sono già pronti, gratis
reveal "<words>" -n 25Dati completi con email controllate, usa crediti
enrich --email a@b.com / --name "..." --domain d / --domain dCompleta un record
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100Trova email di lavoro: 1 credito quando viene trovata, 0,25 quando non si trova nulla
find status / download / resume / cancel <job_id>, find pricingListe e prezzi di Trova email
lists ls / create / show / people / rename / rm / exportListe salvate
lists remove-people <id> --title Intern --preview / --ids a,bToglie persone da una lista salvata. Prima conta e chiede; --preview conta soltanto. Se aggiungi di nuovo la stessa ricerca, restano fuori
export "<words>" -n 1000 -o leads.csvUn CSV di contatti controllati, usa crediti
exports ls / status / downloadLe tue esportazioni
verify <email> / verify --file emails.csv -o checked.csvVerifica le email che hai già
campaigns list / create / update / status / deleteLe campagne e le loro impostazioni
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bouncesTiene gli indirizzi che sono rimbalzati per altri utenti Argorant, oppure li esclude (impostazione predefinita)
campaigns emails set <c> --step 1 --subject ... --body-file fLe email
campaigns leads add <c> --list <id> / leads list / leads removeLe persone in una campagna
campaigns leads add <c> --list <id> --grades validLa risposta quando un'aggiunta chiede quali indirizzi aggiungere. valid (consigliato) aggiunge solo gli indirizzi validi, valid,catch_all anche quelli catch-all
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c>Toglie molte persone in una volta, prima con anteprima; segui l'avanzamento di aggiunte e rimozioni grandi
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag>Assegna un tag alle persone, poi toglile, riportale, spostale o elencale per tag
campaigns leads restore <c> --tag <tag> / --all-removedRiporta le persone tolte che non hanno mai ricevuto email, prima con anteprima
campaigns leads move <c> --to <c2> --tag <tag>Sposta persone in un'altra campagna con i loro campi, prima con anteprima
campaigns personalize import <c> lines.csvRighe personali per molte persone da un solo file
campaigns test <c> --step 1Un'email di test a te, non aggiunge nessuno
campaigns folders / folders create --name / move <c> --folder <f>Cartelle per le campagne
campaigns list --folder <f> / --no-folderLe campagne di una cartella, o quelle senza cartella
campaigns senders set <c> --all / senders list / senders removeLe caselle di invio
campaigns launch / pause / stop <c>Avvia o ferma l'invio; l'avvio chiede prima conferma, -y salta la domanda
campaigns analytics <c> --days 30 / campaigns replies <c>Risultati e risposte di una campagna
inbox list / read / reply / forward / classifyTutte le risposte in un unico posto
inbox stages / stages add / set / rmLe fasi della tua pipeline per le risposte
inboxes list --status needs_attention --tag t / set / disconnect / connect-googleLe tue caselle
inboxes update --domains a.com --daily-limit 30Modifica molte caselle in una volta, prima con anteprima
inboxes set <mailbox> --name "Elena Vaughn"Il nome del mittente che le persone vedono, una casella alla volta
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push"I tag delle caselle con i loro conteggi, tag per molte caselle in una volta (prima con anteprima) e i tag di un ordine, che arrivano anche alle caselle che l'ordine crea in seguito (guida)
inboxes test-smtp / connect-smtp / connect-smtp --csv / presetsCaselle di qualsiasi provider (guida); la password viene chiesta o letta da una variabile d'ambiente, mai dalla riga di comando
inboxes quote / order / status / renewalNuove caselle su nuovi domini
blocklist list / add / remove / jobIndirizzi e domini che non vengono mai contattati. list ne mostra 50 alla volta (--all, --search, --campaign); add e remove accettano molti valori o --file list.csv (chiamate da 5.000), --campaign per singole campagne e --dry-run
webhooks ls / add / set / test / deliveries / rmEventi inviati al tuo server, dal piano Pro

Filtri

Ogni comando di ricerca (count, search, reveal, export, lists create, l'aggiunta a una lista, companies) accetta gli stessi filtri dell'app, dell'API e del connettore Claude. Una virgola significa uno qualsiasi. Ogni filtro a lista ha un gemello di esclusione che toglie tutti quelli che il filtro di inclusione troverebbe per gli stessi valori, e si possono usare entrambi insieme.

IncludiEscludiCosa trova
--title--exclude-titleQualifiche; le forme brevi funzionano in entrambi i sensi (CFO, Chief Financial Officer)
--keywords--exclude-keywordsParole che descrivono cosa fa l'azienda, come fintech (--keyword-scope people per le competenze delle persone)
--industry--exclude-industrySettori in parole semplici
--country--exclude-countryPaesi o regioni come DACH, Nordics, APAC
--state--exclude-stateStati o province, per nome o sigla
--city--exclude-cityCittà
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales, Marketing, Engineering, Finance e gli altri reparti
--domain--exclude-domainSiti web aziendali, come stripe.com

Come vengono confrontate le parole:

  • --title-match words (predefinito) richiede ogni parola come parola intera, quindi Data non trova Database. exact richiede l'intera qualifica, quindi CEO non trova Founder & CEO. contains trova il testo ovunque, anche dentro una parola.
  • Le parole chiave guardano per impostazione predefinita cosa fa l'azienda (nome, tag, settore e descrizione). --keyword-scope people guarda le competenze e i profili delle persone, e any entrambi più le qualifiche.
  • --industry-match primary trova solo il settore principale dell'azienda, quindi Software esclude un rivenditore o una banca che ha anche un tag software. any (predefinito) trova uno qualsiasi dei suoi settori.
  • --country-match person (predefinito) considera dove si trova la persona ed esclude le persone di cui non si conosce la sede. person_or_company usa per loro il paese dell'azienda.

Ci sono anche altri filtri, come --employees 51-200, --employees-min e --employees-max, --revenue 10m-50m, --revenue-min e --revenue-max, --company (più aziende: unisci i nomi con |), --has-phone e --has-linkedin. npx argorant filters elenca tutti i filtri che puoi usare.

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

Una lista salvata si riempie in background. lists show <id> dice se si sta ancora riempiendo; un'aggiunta a una lista che si sta ancora riempiendo aspetta il suo turno.

Pensato per script e agenti

  • --json su qualsiasi comando stampa la risposta dell'API così com'è.
  • Gli elenchi stampano un cursore sotto ogni pagina. Passalo con --cursor, oppure aggiungi --all per leggere tutte le pagine.
  • Ogni scrittura riceve un nuovo Idempotency-Key. Passa --idempotency-key <key> per sceglierne uno tuo, così eseguendo di nuovo lo stesso comando ottieni la prima risposta invece di fare il lavoro due volte.
  • I codici di uscita sono 0 per il successo, 1 per un errore (e per find senza risultato), 2 per una chiave mancante o errata, 3 per uno scope mancante, 4 per un limite di richieste o giornaliero, 5 quando serve un piano o più crediti, e 6 quando prima serve una scelta e non è stato cambiato nulla (campaigns leads add chiede quali tipi di indirizzi aggiungere).
  • I comandi che modificano molte persone o caselle (leads remove, leads restore, leads move, lists remove-people, inboxes tag, inboxes update) prima contano e poi chiedono. --preview conta soltanto, e --yes salta la domanda.
  • Gli errori stampano il codice, il messaggio in chiaro e l'id della richiesta.
  • I comandi che spendono crediti chiedono prima conferma in un terminale. Non chiedono quando l'output non è un terminale o con --yes o --json, quindi controlla il tuo -n negli script.
  • Una campagna si può indicare con il suo id o con l'inizio del suo nome.

Da una ricerca a una campagna attiva

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"

In questa pagina