ArgorantDocs

Opdrachtregel

Alles vanuit de terminal met npx argorant. JSON-uitvoer voor scripts en agents, pagina's met een cursor, veilig opnieuw proberen en exitcodes waar je op kunt reageren.

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

npx draait het zonder installatie. Wil je het blijvend installeren, voer dan npm install -g argorant uit. De tool leest de sleutel uit argorant login of uit de variabele ARGORANT_API_KEY.

Opdrachten

OpdrachtWat het doet
accountPlan, credits, aanvraaglimiet en campagne-e-mails
count "<words>" [filters]Passende mensen tellen, gratis
search "<words>" -n 10Een gemaskeerd voorbeeld, gratis
company <domain>Hoeveel mensen er bij één bedrijf werken, gratis
companies count / search / peopleBedrijven die bij je filters passen, gratis
lookup industries / countries / keywords / technologies / titles [text]De exacte namen om op te filteren, gratis
filtersElk zoekfilter met zijn flags en waarden, en welke nu klaar zijn, gratis
reveal "<words>" -n 25Volledige gegevens met gecontroleerde e-mailadressen, kost credits
enrich --email a@b.com / --name "..." --domain d / --domain dEén record aanvullen
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100Zakelijke e-mailadressen vinden: 1 credit als er een is gevonden, 0,25 als er niets is gevonden
find status / download / resume / cancel <job_id>, find pricingLijsten en prijzen van de e-mailfinder
lists ls / create / show / people / rename / rm / exportOpgeslagen lijsten
lists remove-people <id> --title Intern --preview / --ids a,bMensen uit een opgeslagen lijst halen. Het telt eerst en vraagt dan; --preview telt alleen. Voeg je dezelfde zoekopdracht opnieuw toe, dan blijven ze eruit
export "<words>" -n 1000 -o leads.csvEen CSV met gecontroleerde contacten, kost credits
exports ls / status / downloadJe exports
verify <email> / verify --file emails.csv -o checked.csvE-mailadressen controleren die je al hebt
campaigns list / create / update / status / deleteCampagnes en hun instellingen
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bouncesAdressen houden die bij andere Argorant-gebruikers zijn gebounced, of ze weglaten (de standaard)
campaigns emails set <c> --step 1 --subject ... --body-file fDe e-mails
campaigns leads add <c> --list <id> / leads list / leads removeDe mensen in een campagne
campaigns leads add <c> --list <id> --grades validHet antwoord als het toevoegen vraagt welke adressen erbij moeten. valid (aanbevolen) voegt alleen geldige adressen toe, valid,catch_all ook catch-all-adressen
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c>Veel mensen tegelijk eruit halen, eerst met een voorbeeld; grote toevoegingen en verwijderingen volgen
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag>Mensen taggen en ze daarna per tag eruit halen, terughalen, verplaatsen of tonen
campaigns leads restore <c> --tag <tag> / --all-removedVerwijderde mensen terughalen die nog nooit een e-mail kregen, eerst met een voorbeeld
campaigns leads move <c> --to <c2> --tag <tag>Mensen met hun eigen velden naar een andere campagne verplaatsen, eerst met een voorbeeld
campaigns personalize import <c> lines.csvPersoonlijke zinnen voor veel mensen uit één bestand
campaigns test <c> --step 1Eén test-e-mail naar jou, voegt niemand toe
campaigns folders / folders create --name / move <c> --folder <f>Mappen voor campagnes
campaigns list --folder <f> / --no-folderDe campagnes van één map, of die in geen enkele map
campaigns senders set <c> --all / senders list / senders removeDe verzendende mailboxen
campaigns launch / pause / stop <c>Versturen starten of stoppen; bij starten wordt eerst gevraagd, -y slaat de vraag over
campaigns analytics <c> --days 30 / campaigns replies <c>Resultaten en antwoorden van één campagne
inbox list / read / reply / forward / classifyElk antwoord op één plek
inbox stages / stages add / set / rmJe pipelinefasen voor antwoorden
inboxes list --status needs_attention --tag t / set / disconnect / connect-googleJe mailboxen
inboxes update --domains a.com --daily-limit 30Veel mailboxen tegelijk wijzigen, eerst met een voorbeeld
inboxes set <mailbox> --name "Elena Vaughn"De afzendernaam die mensen zien, één mailbox tegelijk
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push"Mailboxtags met hun aantallen, tags voor veel mailboxen tegelijk (eerst met een voorbeeld) en de tags van een bestelling, die ook gelden voor de mailboxen die ze later aanmaakt (gids)
inboxes test-smtp / connect-smtp / connect-smtp --csv / presetsMailboxen van elke aanbieder (gids); het wachtwoord wordt gevraagd of uit een omgevingsvariabele gelezen, nooit van de opdrachtregel
inboxes quote / order / status / renewalNieuwe mailboxen op nieuwe domeinen
blocklist list / add / remove / jobAdressen en domeinen die nooit worden benaderd. list toont er 50 tegelijk (--all, --search, --campaign); add en remove nemen veel waarden of --file list.csv (aanroepen van 5.000), --campaign voor losse campagnes en --dry-run
webhooks ls / add / set / test / deliveries / rmEvents die naar je server worden gestuurd, vanaf het plan Pro

Filters

Elke opdracht om te zoeken (count, search, reveal, export, lists create, toevoegen aan een lijst, companies) neemt dezelfde filters als de app, de API en de Claude-connector. Een komma betekent: een van deze. Elk lijstfilter heeft een tegenhanger om uit te sluiten, die iedereen weghaalt die het insluitende filter voor dezelfde waarden zou vinden, en je kunt ze samen gebruiken.

InsluitenUitsluitenWaarop het filtert
--title--exclude-titleFunctietitels; afkortingen werken in beide richtingen (CFO, Chief Financial Officer)
--keywords--exclude-keywordsWoorden die beschrijven wat het bedrijf doet, zoals fintech (--keyword-scope people voor de eigen vaardigheden van mensen)
--industry--exclude-industryBranches in gewone woorden
--country--exclude-countryLanden of regio's zoals DACH, Nordics, APAC
--state--exclude-stateStaten of provincies, via hun naam of afkorting
--city--exclude-citySteden
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales, Marketing, Engineering, Finance en de andere afdelingen
--domain--exclude-domainWebsites van bedrijven, zoals stripe.com

Zo worden woorden vergeleken:

  • --title-match words (standaard) vereist elk woord als heel woord, dus Data past niet op Database. exact vereist de hele functietitel, dus CEO past niet op Founder & CEO. contains vindt de tekst overal, ook midden in een woord.
  • Trefwoorden kijken standaard naar wat het bedrijf doet (de naam, tags, branche en beschrijving). --keyword-scope people kijkt naar de eigen vaardigheden en profielen van mensen, en any naar beide plus functietitels.
  • --industry-match primary past alleen op de hoofdbranche van het bedrijf, dus Software laat een retailer of een bank weg die ook een softwaretag heeft. any (de standaard) past op elk van zijn branches.
  • --country-match person (de standaard) telt waar de persoon zelf zit en laat mensen weg van wie de eigen locatie niet bekend is. person_or_company gebruikt voor hen het land van het bedrijf.

Er zijn nog meer filters, zoals --employees 51-200, --employees-min en --employees-max, --revenue 10m-50m, --revenue-min en --revenue-max, --company (meerdere bedrijven: zet | tussen de namen), --has-phone en --has-linkedin. npx argorant filters toont elk filter dat je kunt gebruiken.

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

Een opgeslagen lijst vult zich op de achtergrond. lists show <id> laat zien of hij nog wordt gevuld; voeg je iets toe aan een lijst die nog wordt gevuld, dan wacht dat tot het aan de beurt is.

Gemaakt voor scripts en agents

  • --json bij elke opdracht toont het antwoord van de API zoals het is.
  • Lijsten tonen onder elke pagina een cursor. Geef die mee met --cursor, of voeg --all toe om elke pagina te lezen.
  • Elke schrijfopdracht krijgt een nieuwe Idempotency-Key. Geef --idempotency-key <key> mee om je eigen te kiezen. Voer je dezelfde opdracht dan nog eens uit, dan krijg je het eerste antwoord terug en wordt het werk niet twee keer gedaan.
  • Exitcodes zijn 0 bij succes, 1 bij een fout (en bij find zonder resultaat), 2 bij een ontbrekende of verkeerde sleutel, 3 bij een ontbrekende scope, 4 bij een snelheids- of daglimiet, 5 als er een plan of meer credits nodig zijn, en 6 als er eerst een keuze nodig is en er niets is gewijzigd (campaigns leads add vraagt welke soorten adressen erbij moeten).
  • Opdrachten die veel mensen of mailboxen wijzigen (leads remove, leads restore, leads move, lists remove-people, inboxes tag, inboxes update) tellen eerst en vragen dan. --preview telt alleen, en --yes slaat de vraag over.
  • Fouten tonen de code, de melding in gewone taal en de request-id.
  • Opdrachten die credits kosten, vragen in een terminal eerst om bevestiging. Ze vragen niets als de uitvoer geen terminal is of met --yes of --json, dus controleer in scripts je -n.
  • Een campagne kun je aanduiden met haar id of met het begin van haar naam.

Van een zoekopdracht naar een lopende campagne

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"

Op deze pagina