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.
npx argorant login # paste a key from app.argorant.com/profile once
npx argorant account # plan, credits, request limit, campaign emailsnpx 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
| Comando | Qué hace |
|---|---|
account | Plan, créditos, límite de solicitudes y correos de campaña |
count "<words>" [filters] | Cuenta las personas que coinciden, gratis |
search "<words>" -n 10 | Una vista previa con datos ocultos, gratis |
company <domain> | Cuántas personas hay en una empresa, gratis |
companies count / search / people | Empresas que encajan con tus filtros, gratis |
lookup industries / countries / keywords / technologies / titles [text] | Los nombres exactos para filtrar, gratis |
filters | Todos los filtros de búsqueda con sus flags y valores, y cuáles están listos ya, gratis |
reveal "<words>" -n 25 | Datos completos con correos comprobados, gasta créditos |
enrich --email a@b.com / --name "..." --domain d / --domain d | Completa un registro |
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100 | Encuentra correos corporativos: 1 crédito si se encuentra, 0,25 si no se encuentra nada |
find status / download / resume / cancel <job_id>, find pricing | Listas y precios del buscador de correos |
lists ls / create / show / people / rename / rm / export | Listas guardadas |
lists remove-people <id> --title Intern --preview / --ids a,b | Saca 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.csv | Un CSV de contactos comprobados, gasta créditos |
exports ls / status / download | Tus exportaciones |
verify <email> / verify --file emails.csv -o checked.csv | Comprueba correos que ya tienes |
campaigns list / create / update / status / delete | Campañas y su configuración |
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bounces | Mantiene las direcciones que rebotaron para otros usuarios de Argorant, o las deja fuera (por defecto) |
campaigns emails set <c> --step 1 --subject ... --body-file f | Los correos |
campaigns leads add <c> --list <id> / leads list / leads remove | Las personas de una campaña |
campaigns leads add <c> --list <id> --grades valid | La 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-removed | Recupera 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.csv | Líneas personales para muchas personas desde un solo archivo |
campaigns test <c> --step 1 | Un 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-folder | Las campañas de una carpeta, o las que no están en ninguna |
campaigns senders set <c> --all / senders list / senders remove | Los 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 / classify | Todas las respuestas en un solo lugar |
inbox stages / stages add / set / rm | Las etapas de tu pipeline para las respuestas |
inboxes list --status needs_attention --tag t / set / disconnect / connect-google | Tus buzones |
inboxes update --domains a.com --daily-limit 30 | Cambia 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 / presets | Buzones 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 / renewal | Buzones nuevos en dominios nuevos |
blocklist list / add / remove / job | Direcciones 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 / rm | Eventos 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.
| Incluir | Excluir | Qué filtra |
|---|---|---|
--title | --exclude-title | Cargos; las formas cortas funcionan en los dos sentidos (CFO, Chief Financial Officer) |
--keywords | --exclude-keywords | Palabras que describen lo que hace la empresa, como fintech (--keyword-scope people para las habilidades de las propias personas) |
--industry | --exclude-industry | Sectores en palabras normales |
--country | --exclude-country | Países o regiones como DACH, Nordics, APAC |
--state | --exclude-state | Estados o provincias, por nombre o código |
--city | --exclude-city | Ciudades |
--seniority | --exclude-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales, Marketing, Engineering, Finance y los demás departamentos |
--domain | --exclude-domain | Sitios 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.exactexige el cargo completo, así que CEO no coincide con Founder & CEO.containsencuentra 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 peoplemira las habilidades y perfiles de las propias personas, yanyambas cosas además de los cargos. --industry-match primarycoincide 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_companyusa 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.
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 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
--jsonen 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--allpara leer todas las páginas. - Cada escritura recibe un
Idempotency-Keynuevo. 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
0para éxito,1para un error (y parafindsin resultado),2para una clave que falta o es incorrecta,3para un scope que falta,4para un límite de solicitudes o diario,5cuando hace falta un plan o más créditos, y6cuando antes hace falta elegir algo y no se ha cambiado nada (campaigns leads addpregunta 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.--previewsolo cuenta, y--yesse 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
--yeso--json, así que revisa tu-nen 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
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"Enviar personas a tus otras herramientas
Envía una exportación a la herramienta de envío que ya usas, en tu propia cuenta. Una lista se envía como su exportación. Incluido desde el plan Pro.
Integraciones
Envía las personas que encuentras en Argorant a las herramientas que ya usas, o llama a Argorant desde tus propias automatizaciones.