인증
API 키, 기본 URL, 키 범위별로 허용되는 작업, 그리고 AI 에이전트가 키 없이 로그인하는 방법입니다.
기본 URL
https://app.argorant.com/api/v1API 키
app.argorant.com/profile에 로그인하고 API 키에서 키를 만드세요. 키는 ag_live_로 시작하며 한 번만 표시됩니다. 각 키에는 zapier, ci, laptop처럼 그 키를 쓰는 대상의 이름을 붙이세요. 그러면 다른 키에 영향을 주지 않고 하나만 취소할 수 있습니다.
모든 호출에 키를 함께 보내세요.
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"응답에는 키가 누구로 동작하는지, 플랜, 크레딧, 키가 분당 보낼 수 있는 요청 수, 오늘 남은 한도가 나옵니다. 큰 작업 전에 호출해 보세요.
API 키는 7일 체험 기간과 모든 플랜에서 작동합니다. 명령줄 도구는 npx argorant login 또는 ARGORANT_API_KEY 변수에서 같은 키를 읽습니다.
범위
앱에서 만든 키는 아래 범위를 모두 가집니다. 범위가 좁은 키로 범위 밖의 작업을 호출하면 403과 scope_missing 코드를 받습니다.
| 범위 | 허용하는 작업 | 발생할 수 있는 비용 |
|---|---|---|
argorant:read_counts | 집계, 단어 목록, 계정, 캠페인 조회, 받은편지함, 메일함, 웹훅 | 없음 |
argorant:search_segments | 인물과 기업의 가려진 미리보기 | 없음 |
argorant:manage_lists | 리스트, 캠페인, 시작, 답장, 상태, 메일함, 차단 리스트, 웹훅, 메일함 주문 | 메일함 주문은 승인 후 비용이 발생 |
argorant:unlock_contacts | 공개, 전화번호, 인물 보강, 이메일 찾기 | 크레딧 |
argorant:create_exports | 내보내기와 리스트 내보내기 | 크레딧 |
argorant:verify_emails | 내 리스트 검증 | 크레딧, 새로 검증할 때마다 0.5크레딧 |
AI 에이전트는 로그인할 뿐, 키를 보지 않습니다
Claude, ChatGPT 같은 MCP 클라이언트는 https://mcp.argorant.com/mcp에 연결하고 OAuth 2.1(PKCE를 사용하는 인가 코드 방식)로 로그인합니다. 클라이언트는 사용자가 승인한 범위로 계정을 대신해 작업하며, API 키는 채팅에 들어가지 않습니다. 클라이언트 연결을 참고하세요.
워크스페이스 안의 권한
키는 그 키를 만든 사람으로 동작합니다. 소유주와 멤버는 자기 워크스페이스만 볼 수 있습니다. 메일함 주문 같은 일부 작업은 워크스페이스 소유주만 할 수 있으며, 멤버가 시도하면 그 이유를 쉬운 말로 알려 주는 메시지와 함께 403을 받습니다. 다른 워크스페이스의 항목은 존재하지 않는 항목과 똑같이 항상 404 not_found로 응답합니다.