ArgorantDocs

Línea de comandos

Todo desde la terminal con npx argorant: salida JSON para scripts y agentes, páginas con cursor, reintentos seguros y códigos de salida con los que puedes actuar.

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

npx la ejecuta sin instalarla. Para instalarla de forma permanente, ejecuta npm install -g argorant. La herramienta lee la clave de argorant login o de la variable ARGORANT_API_KEY.

Comandos

ComandoQué hace
accountPlan, créditos, límite de solicitudes y correos de campaña
count "<words>" [filters]Cuenta las personas que coinciden, gratis
search "<words>" -n 10Una vista previa con datos ocultos, gratis
company <domain>Cuántas personas hay en una empresa, gratis
companies count / search / peopleEmpresas que encajan con tus filtros, gratis
lookup industries / countries / keywords / technologies / titles [text]Los nombres exactos para filtrar, gratis
filtersTodos los filtros de búsqueda con sus flags y valores, y cuáles están listos ya, gratis
reveal "<words>" -n 25Datos completos con correos comprobados, gasta créditos
enrich --email a@b.com / --name "..." --domain d / --domain dCompleta un registro
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100Encuentra correos corporativos: 1 crédito si se encuentra, 0,25 si no se encuentra nada
find status / download / resume / cancel <job_id>, find pricingListas y precios del buscador de correos
lists ls / create / show / people / rename / rm / exportListas guardadas
lists remove-people <id> --title Intern --preview / --ids a,bSaca personas de una lista guardada. Primero cuenta y pregunta; --preview solo cuenta. Si vuelves a añadir la misma búsqueda, siguen fuera
export "<words>" -n 1000 -o leads.csvUn CSV de contactos comprobados, gasta créditos
exports ls / status / downloadTus exportaciones
verify <email> / verify --file emails.csv -o checked.csvComprueba correos que ya tienes
campaigns list / create / update / status / deleteCampañas y su configuración
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bouncesMantiene las direcciones que rebotaron para otros usuarios de Argorant, o las deja fuera (por defecto)
campaigns emails set <c> --step 1 --subject ... --body-file fLos correos
campaigns leads add <c> --list <id> / leads list / leads removeLas personas de una campaña
campaigns leads add <c> --list <id> --grades validLa respuesta cuando una adición pregunta qué direcciones añadir. valid (recomendado) añade solo direcciones válidas, valid,catch_all también las catch-all
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c>Saca a muchas personas a la vez, con vista previa primero; sigue las adiciones y eliminaciones grandes
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag>Etiqueta personas y luego sácalas, recupéralas, muévelas o lístalas por etiqueta
campaigns leads restore <c> --tag <tag> / --all-removedRecupera a las personas sacadas que nunca recibieron un correo, con vista previa primero
campaigns leads move <c> --to <c2> --tag <tag>Mueve personas a otra campaña con sus propios campos, con vista previa primero
campaigns personalize import <c> lines.csvLíneas personales para muchas personas desde un solo archivo
campaigns test <c> --step 1Un correo de prueba para ti, no añade a nadie
campaigns folders / folders create --name / move <c> --folder <f>Carpetas para campañas
campaigns list --folder <f> / --no-folderLas campañas de una carpeta, o las que no están en ninguna
campaigns senders set <c> --all / senders list / senders removeLos buzones de envío
campaigns launch / pause / stop <c>Inicia o detiene el envío; el lanzamiento pregunta primero, -y se salta la pregunta
campaigns analytics <c> --days 30 / campaigns replies <c>Resultados y respuestas de una campaña
inbox list / read / reply / forward / classifyTodas las respuestas en un solo lugar
inbox stages / stages add / set / rmLas etapas de tu pipeline para las respuestas
inboxes list --status needs_attention --tag t / set / disconnect / connect-googleTus buzones
inboxes update --domains a.com --daily-limit 30Cambia muchos buzones a la vez, con vista previa primero
inboxes set <mailbox> --name "Elena Vaughn"El nombre de remitente que ve la gente, buzón por buzón
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push"Las etiquetas de buzones con sus recuentos, etiquetas para muchos buzones a la vez (con vista previa primero) y las etiquetas de un pedido, que también llegan a los buzones que configure más tarde (guía)
inboxes test-smtp / connect-smtp / connect-smtp --csv / presetsBuzones de cualquier proveedor (guía); la contraseña se pide o se lee de una variable de entorno, nunca de la línea de comandos
inboxes quote / order / status / renewalBuzones nuevos en dominios nuevos
blocklist list / add / remove / jobDirecciones y dominios a los que nunca se escribe. list muestra 50 cada vez (--all, --search, --campaign); add y remove aceptan muchos valores o --file list.csv (llamadas de 5.000), --campaign para campañas concretas y --dry-run
webhooks ls / add / set / test / deliveries / rmEventos enviados a tu servidor, desde el plan Pro

Filtros

Todos los comandos de búsqueda (count, search, reveal, export, lists create, añadir a una lista, companies) aceptan los mismos filtros que la app, la API y el conector de Claude. Una coma significa cualquiera de ellos. Cada filtro de lista tiene un gemelo de exclusión que quita a todas las personas que el filtro de inclusión encontraría con los mismos valores, y se pueden usar los dos juntos.

IncluirExcluirQué filtra
--title--exclude-titleCargos; las formas cortas funcionan en los dos sentidos (CFO, Chief Financial Officer)
--keywords--exclude-keywordsPalabras que describen lo que hace la empresa, como fintech (--keyword-scope people para las habilidades de las propias personas)
--industry--exclude-industrySectores en palabras normales
--country--exclude-countryPaíses o regiones como DACH, Nordics, APAC
--state--exclude-stateEstados o provincias, por nombre o código
--city--exclude-cityCiudades
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales, Marketing, Engineering, Finance y los demás departamentos
--domain--exclude-domainSitios web de empresas, como stripe.com

Cómo coinciden las palabras:

  • --title-match words (por defecto) exige cada palabra como palabra completa, así que Data no coincide con Database. exact exige el cargo completo, así que CEO no coincide con Founder & CEO. contains encuentra el texto en cualquier parte, también dentro de una palabra.
  • Por defecto, las palabras clave miran lo que hace la empresa (su nombre, etiquetas, sector y descripción). --keyword-scope people mira las habilidades y perfiles de las propias personas, y any ambas cosas además de los cargos.
  • --industry-match primary coincide solo con el sector principal de la empresa, así que Software deja fuera a un comercio o un banco que también lleva una etiqueta de software. any (por defecto) coincide con cualquiera de sus sectores.
  • --country-match person (por defecto) cuenta dónde está la persona y deja fuera a las personas cuya ubicación propia no se conoce. person_or_company usa para ellas el país de la empresa.

Hay más filtros, como --employees 51-200, --employees-min y --employees-max, --revenue 10m-50m, --revenue-min y --revenue-max, --company (varias empresas: une los nombres con |), --has-phone y --has-linkedin. npx argorant filters lista todos los filtros que puedes usar.

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 guardada se llena en segundo plano. lists show <id> indica si todavía se está llenando; añadir a una lista que aún se está llenando espera su turno.

Pensada para scripts y agentes

  • --json en cualquier comando imprime la respuesta de la API tal cual.
  • Las listas imprimen un cursor debajo de cada página. Pásalo con --cursor, o añade --all para leer todas las páginas.
  • Cada escritura recibe un Idempotency-Key nuevo. Pasa --idempotency-key <key> para elegir el tuyo, de modo que al volver a ejecutar el mismo comando recibas la primera respuesta en lugar de repetir el trabajo.
  • Los códigos de salida son 0 para éxito, 1 para un error (y para find sin resultado), 2 para una clave que falta o es incorrecta, 3 para un scope que falta, 4 para un límite de solicitudes o diario, 5 cuando hace falta un plan o más créditos, y 6 cuando antes hace falta elegir algo y no se ha cambiado nada (campaigns leads add pregunta qué tipos de direcciones añadir).
  • Los comandos que cambian muchas personas o buzones (leads remove, leads restore, leads move, lists remove-people, inboxes tag, inboxes update) primero cuentan y luego preguntan. --preview solo cuenta, y --yes se salta la pregunta.
  • Los errores imprimen el código, el mensaje en texto claro y el id de la solicitud.
  • Los comandos que gastan créditos preguntan antes en una terminal. No preguntan cuando la salida no es una terminal, ni con --yes o --json, así que revisa tu -n en los scripts.
  • Puedes indicar una campaña por su id o por el principio de su nombre.

De una búsqueda a una campaña en marcha

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"

En esta página