명령줄
npx argorant로 터미널에서 모든 작업을 합니다. 스크립트와 에이전트를 위한 JSON 출력, 커서로 넘기는 페이지, 안전한 재시도, 그리고 그대로 대응할 수 있는 종료 코드를 제공합니다.
npx argorant login # paste a key from app.argorant.com/profile once
npx argorant account # plan, credits, request limit, campaign emailsnpx는 설치하지 않고 바로 실행합니다. 계속 쓰도록 설치하려면 npm install -g argorant를 실행하세요. 이 도구는 argorant login에서 넣은 키나 ARGORANT_API_KEY 변수에서 키를 읽습니다.
명령
| 명령 | 하는 일 |
|---|---|
account | 플랜, 크레딧, 요청 한도, 캠페인 이메일 |
count "<words>" [filters] | 조건에 맞는 인물 집계, 무료 |
search "<words>" -n 10 | 가려진 미리보기, 무료 |
company <domain> | 한 기업의 인물 수, 무료 |
companies count / search / people | 필터에 맞는 기업, 무료 |
lookup industries / countries / keywords / technologies / titles [text] | 필터에 쓸 정확한 이름, 무료 |
filters | 모든 검색 필터와 그 플래그, 값, 지금 쓸 수 있는지 여부, 무료 |
reveal "<words>" -n 25 | 검증된 이메일이 포함된 전체 정보, 크레딧 사용 |
enrich --email a@b.com / --name "..." --domain d / --domain d | 레코드 하나 보강 |
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100 | 업무용 이메일 찾기. 찾으면 1크레딧, 찾지 못하면 0.25크레딧 |
find status / download / resume / cancel <job_id>, find pricing | 이메일 찾기 리스트와 가격 |
lists ls / create / show / people / rename / rm / export | 저장된 리스트 |
lists remove-people <id> --title Intern --preview / --ids a,b | 저장된 리스트에서 인물 빼기. 먼저 집계하고 확인을 묻습니다. --preview는 집계만 합니다. 같은 검색을 다시 추가해도 빠진 인물은 제외됩니다 |
export "<words>" -n 1000 -o leads.csv | 검증된 연락처의 CSV, 크레딧 사용 |
exports ls / status / download | 내 내보내기 |
verify <email> / verify --file emails.csv -o checked.csv | 이미 가진 이메일 검증 |
campaigns list / create / update / status / delete | 캠페인과 그 설정 |
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bounces | 다른 Argorant 사용자에게서 반송된 주소를 유지하거나 제외(기본값) |
campaigns emails set <c> --step 1 --subject ... --body-file f | 이메일 |
campaigns leads add <c> --list <id> / leads list / leads remove | 캠페인의 인물 |
campaigns leads add <c> --list <id> --grades valid | 추가할 때 어떤 주소를 넣을지 물으면 하는 응답. valid(권장)는 유효한 주소만, valid,catch_all은 catch-all 주소도 추가합니다 |
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c> | 많은 인물을 한 번에 빼기(먼저 미리보기), 대량 추가와 삭제 진행 확인 |
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag> | 인물에 태그를 단 뒤 태그로 빼기, 되돌리기, 옮기기, 목록 보기 |
campaigns leads restore <c> --tag <tag> / --all-removed | 뺐지만 아직 이메일을 받지 않은 인물 되돌리기, 먼저 미리보기 |
campaigns leads move <c> --to <c2> --tag <tag> | 인물을 자기 필드와 함께 다른 캠페인으로 옮기기, 먼저 미리보기 |
campaigns personalize import <c> lines.csv | 많은 인물의 맞춤 문장을 파일 하나로 |
campaigns test <c> --step 1 | 나에게 테스트 이메일 한 통, 아무도 추가하지 않음 |
campaigns folders / folders create --name / move <c> --folder <f> | 캠페인 폴더 |
campaigns list --folder <f> / --no-folder | 한 폴더의 캠페인 또는 폴더에 없는 캠페인 |
campaigns senders set <c> --all / senders list / senders remove | 발송 메일함 |
campaigns launch / pause / stop <c> | 발송 시작 또는 중지. 시작할 때 먼저 확인을 묻고, -y는 질문을 건너뜁니다 |
campaigns analytics <c> --days 30 / campaigns replies <c> | 캠페인 하나의 결과와 답장 |
inbox list / read / reply / forward / classify | 모든 답장을 한곳에서 |
inbox stages / stages add / set / rm | 답장의 파이프라인 단계 |
inboxes list --status needs_attention --tag t / set / disconnect / connect-google | 내 메일함 |
inboxes update --domains a.com --daily-limit 30 | 많은 메일함을 한 번에 변경, 먼저 미리보기 |
inboxes set <mailbox> --name "Elena Vaughn" | 받는 사람에게 보이는 발신자 이름, 메일함 하나씩 |
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push" | 개수가 표시되는 메일함 태그, 많은 메일함에 한 번에 다는 태그(먼저 미리보기), 그리고 나중에 설정되는 메일함에도 적용되는 주문의 태그(가이드) |
inboxes test-smtp / connect-smtp / connect-smtp --csv / presets | 모든 서비스 제공업체의 메일함(가이드). 비밀번호는 물어보거나 환경 변수에서 읽으며, 명령줄에서는 절대 받지 않습니다 |
inboxes quote / order / status / renewal | 새 도메인의 새 메일함 |
blocklist list / add / remove / job | 절대 연락하지 않는 주소와 도메인. list는 한 번에 50개씩 보여 줍니다(--all, --search, --campaign). add와 remove는 여러 값이나 --file list.csv(호출당 5,000개), 개별 캠페인용 --campaign, --dry-run을 받습니다 |
webhooks ls / add / set / test / deliveries / rm | 내 서버로 보내는 이벤트, Pro 플랜부터 |
필터
모든 검색 명령(count, search, reveal, export, lists create, 리스트에 추가, companies)은 앱, API, Claude 커넥터와 같은 필터를 받습니다. 쉼표는 그중 하나라도 맞으면 된다는 뜻입니다. 각 리스트 필터에는 제외용 짝이 있어서, 같은 값에 대해 포함 필터가 찾을 모든 인물을 빼며, 둘을 함께 쓸 수 있습니다.
| 포함 | 제외 | 일치 대상 |
|---|---|---|
--title | --exclude-title | 직함. 약어는 양방향으로 인식됩니다(CFO, Chief Financial Officer) |
--keywords | --exclude-keywords | fintech처럼 기업이 하는 일을 설명하는 단어(인물 자신의 기술은 --keyword-scope people) |
--industry | --exclude-industry | 일반 단어로 쓴 업종 |
--country | --exclude-country | 국가 또는 DACH, Nordics, APAC 같은 지역 |
--state | --exclude-state | 주 또는 도, 이름이나 코드로 |
--city | --exclude-city | 도시 |
--seniority | --exclude-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales, Marketing, Engineering, Finance 등의 부서 |
--domain | --exclude-domain | stripe.com 같은 회사 웹사이트 |
단어가 일치하는 방식은 다음과 같습니다.
--title-match words(기본값)는 모든 단어가 온전한 단어로 들어 있어야 하므로 Data는 Database와 일치하지 않습니다.exact는 직함 전체가 같아야 하므로 CEO는 Founder & CEO와 일치하지 않습니다.contains는 단어 안에 들어 있는 경우를 포함해 어디서든 텍스트를 찾습니다.- 키워드는 기본적으로 기업이 하는 일(기업의 이름, 태그, 업종, 설명)을 봅니다.
--keyword-scope people은 인물 자신의 기술과 프로필을,any는 둘 다와 직함까지 봅니다. --industry-match primary는 기업의 주 업종만 일치시키므로, Software로 찾으면 software 태그도 있는 소매업체나 은행은 제외됩니다.any(기본값)는 기업의 모든 업종과 일치시킵니다.--country-match person(기본값)은 인물이 있는 곳을 기준으로 집계하며, 인물 자신의 위치를 알 수 없는 경우는 제외합니다.person_or_company는 그런 인물에 대해 기업의 국가를 씁니다.
--employees 51-200, --employees-min과 --employees-max, --revenue 10m-50m, --revenue-min과 --revenue-max, --company(여러 기업은 이름을 |로 연결), --has-phone, --has-linkedin 같은 필터도 더 있습니다. npx argorant filters는 쓸 수 있는 모든 필터를 보여 줍니다.
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저장된 리스트는 백그라운드에서 채워집니다. lists show <id>는 아직 채워지는 중인지 알려 주며, 채워지는 중인 리스트에 추가하면 차례를 기다립니다.
스크립트와 에이전트를 위한 설계
- 어떤 명령이든
--json을 붙이면 API의 응답을 그대로 출력합니다. - 리스트는 각 페이지 아래에 커서를 출력합니다.
--cursor로 넘기거나,--all을 추가해 모든 페이지를 읽으세요. - 모든 쓰기 작업에는 새
Idempotency-Key가 붙습니다. 직접 정하려면--idempotency-key <key>를 넘기세요. 그러면 같은 명령을 다시 실행해도 작업을 두 번 하지 않고 첫 응답을 돌려줍니다. - 종료 코드는 성공이면
0, 오류이면1(결과가 없는find도 포함), 키가 없거나 틀리면2, 범위가 없으면3, 속도 한도나 일일 한도에 걸리면4, 플랜이나 크레딧이 더 필요하면5, 먼저 선택이 필요해 아무것도 바뀌지 않았으면6입니다(campaigns leads add는 어떤 종류의 주소를 추가할지 묻습니다). - 많은 인물이나 메일함을 바꾸는 명령(
leads remove,leads restore,leads move,lists remove-people,inboxes tag,inboxes update)은 먼저 집계한 다음 확인을 묻습니다.--preview는 집계만 하고,--yes는 질문을 건너뜁니다. - 오류가 나면 코드, 쉬운 문장으로 된 메시지, 요청 ID를 출력합니다.
- 크레딧을 쓰는 명령은 터미널에서 먼저 확인을 묻습니다. 출력이 터미널이 아니거나
--yes또는--json을 붙이면 묻지 않으므로, 스크립트에서는-n을 꼭 확인하세요. - 캠페인은 ID나 이름의 앞부분으로 지정할 수 있습니다.
검색부터 캠페인 실행까지
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"