ArgorantDocs

명령줄

npx argorant로 터미널에서 모든 작업을 합니다. 스크립트와 에이전트를 위한 JSON 출력, 커서로 넘기는 페이지, 안전한 재시도, 그리고 그대로 대응할 수 있는 종료 코드를 제공합니다.

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

npx는 설치하지 않고 바로 실행합니다. 계속 쓰도록 설치하려면 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-keywordsfintech처럼 기업이 하는 일을 설명하는 단어(인물 자신의 기술은 --keyword-scope people)
--industry--exclude-industry일반 단어로 쓴 업종
--country--exclude-country국가 또는 DACH, Nordics, APAC 같은 지역
--state--exclude-state주 또는 도, 이름이나 코드로
--city--exclude-city도시
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales, Marketing, Engineering, Finance 등의 부서
--domain--exclude-domainstripe.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는 쓸 수 있는 모든 필터를 보여 줍니다.

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

저장된 리스트는 백그라운드에서 채워집니다. 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나 이름의 앞부분으로 지정할 수 있습니다.

검색부터 캠페인 실행까지

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"

이 페이지의 내용