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.
npx argorant login # paste a key from app.argorant.com/profile once
npx argorant account # plan, credits, request limit, campaign emailsnpx 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
| Comando | Cosa fa |
|---|---|
account | Piano, crediti, limite di richieste ed email di campagna |
count "<words>" [filters] | Conta le persone corrispondenti, gratis |
search "<words>" -n 10 | Un'anteprima mascherata, gratis |
company <domain> | Quante persone ci sono in un'azienda, gratis |
companies count / search / people | Le aziende che corrispondono ai tuoi filtri, gratis |
lookup industries / countries / keywords / technologies / titles [text] | I nomi esatti da usare nei filtri, gratis |
filters | Ogni filtro di ricerca con i suoi flag e valori, e quali sono già pronti, gratis |
reveal "<words>" -n 25 | Dati completi con email controllate, usa crediti |
enrich --email a@b.com / --name "..." --domain d / --domain d | Completa un record |
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100 | Trova email di lavoro: 1 credito quando viene trovata, 0,25 quando non si trova nulla |
find status / download / resume / cancel <job_id>, find pricing | Liste e prezzi di Trova email |
lists ls / create / show / people / rename / rm / export | Liste salvate |
lists remove-people <id> --title Intern --preview / --ids a,b | Toglie 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.csv | Un CSV di contatti controllati, usa crediti |
exports ls / status / download | Le tue esportazioni |
verify <email> / verify --file emails.csv -o checked.csv | Verifica le email che hai già |
campaigns list / create / update / status / delete | Le campagne e le loro impostazioni |
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bounces | Tiene gli indirizzi che sono rimbalzati per altri utenti Argorant, oppure li esclude (impostazione predefinita) |
campaigns emails set <c> --step 1 --subject ... --body-file f | Le email |
campaigns leads add <c> --list <id> / leads list / leads remove | Le persone in una campagna |
campaigns leads add <c> --list <id> --grades valid | La 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-removed | Riporta 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.csv | Righe personali per molte persone da un solo file |
campaigns test <c> --step 1 | Un'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-folder | Le campagne di una cartella, o quelle senza cartella |
campaigns senders set <c> --all / senders list / senders remove | Le 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 / classify | Tutte le risposte in un unico posto |
inbox stages / stages add / set / rm | Le fasi della tua pipeline per le risposte |
inboxes list --status needs_attention --tag t / set / disconnect / connect-google | Le tue caselle |
inboxes update --domains a.com --daily-limit 30 | Modifica 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 / presets | Caselle di qualsiasi provider (guida); la password viene chiesta o letta da una variabile d'ambiente, mai dalla riga di comando |
inboxes quote / order / status / renewal | Nuove caselle su nuovi domini |
blocklist list / add / remove / job | Indirizzi 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 / rm | Eventi 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.
| Includi | Escludi | Cosa trova |
|---|---|---|
--title | --exclude-title | Qualifiche; le forme brevi funzionano in entrambi i sensi (CFO, Chief Financial Officer) |
--keywords | --exclude-keywords | Parole che descrivono cosa fa l'azienda, come fintech (--keyword-scope people per le competenze delle persone) |
--industry | --exclude-industry | Settori in parole semplici |
--country | --exclude-country | Paesi o regioni come DACH, Nordics, APAC |
--state | --exclude-state | Stati o province, per nome o sigla |
--city | --exclude-city | Città |
--seniority | --exclude-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales, Marketing, Engineering, Finance e gli altri reparti |
--domain | --exclude-domain | Siti 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.exactrichiede l'intera qualifica, quindi CEO non trova Founder & CEO.containstrova 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 peopleguarda le competenze e i profili delle persone, eanyentrambi più le qualifiche. --industry-match primarytrova 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_companyusa 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.
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.csvUna 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
--jsonsu qualsiasi comando stampa la risposta dell'API così com'è.- Gli elenchi stampano un cursore sotto ogni pagina. Passalo con
--cursor, oppure aggiungi--allper 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
0per il successo,1per un errore (e perfindsenza risultato),2per una chiave mancante o errata,3per uno scope mancante,4per un limite di richieste o giornaliero,5quando serve un piano o più crediti, e6quando prima serve una scelta e non è stato cambiato nulla (campaigns leads addchiede 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.--previewconta soltanto, e--yessalta 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
--yeso--json, quindi controlla il tuo-nnegli script. - Una campagna si può indicare con il suo id o con l'inizio del suo nome.
Da una ricerca a una campagna attiva
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"Invia le persone ai tuoi altri strumenti
Invia un'esportazione allo strumento di invio che usi già, nel tuo account lì. Una lista viene inviata come sua esportazione. Incluso dal piano Pro.
Integrazioni
Invia le persone che trovi in Argorant agli strumenti che già usi, oppure chiama Argorant dalle tue automazioni.