Hunter Automation
Hunter.io를 활용한 아웃리치를 강화하세요 -- 자연어 명령만으로 도메인별 이메일 주소 발견, 특정 인물의 이메일 찾기, 전달 가능성 확인, 리드 저장, API 사용량 추적이 가능합니다.
툴킷 문서: composio.dev/toolkits/hunter
설정
- 클라이언트 설정에 Composio MCP 서버를 추가하세요:
https://rube.app/mcp - 메시지가 표시되면 Hunter.io 계정을 연결하세요 (API 키 인증).
- 이메일을 찾고 검증하는 자연어 명령을 내리기 시작하세요.
핵심 워크플로
1. 도메인에서 이메일 주소 검색
특정 도메인이나 회사의 모든 공개 이메일 주소를 부서, 직급, 유형별로 필터링하여 찾습니다.
도구: HUNTER_DOMAIN_SEARCH
예시 프롬프트:
"Hunter를 사용해 stripe.com의 모든 임원 이메일 주소를 찾아줘"
주요 매개변수:
domain-- 검색할 도메인 (예: "stripe.com").company가 제공되지 않으면 필수.company-- 검색할 회사명 (예: "Stripe").domain이 제공되지 않으면 필수.type-- "personal" 또는 "generic" 이메일로 필터링seniority-- 레벨별 필터: "junior", "senior", "executive" (배열)department-- 부서별 필터: "executive", "it", "finance", "sales" 등 (배열)required_field-- 특정 필드 요구: "full_name", "position", "phone_number" (배열)limit-- 요청당 최대 결과 수 (1-100, 기본값 10; 무료/기본 플랜은 10으로 제한)offset-- 페이지네이션을 위한 건너뛸 결과 수 (기본값 0)
2. 특정 인물의 이메일 찾기
이름과 도메인 또는 회사가 주어졌을 때 가장 가능성 높은 이메일 주소를 추론합니다.
도구: HUNTER_EMAIL_FINDER
예시 프롬프트:
"Hunter를 사용해 reddit.com에서 Alexis Ohanian의 이메일을 찾아줘"
주요 매개변수:
domain-- 대상 도메인 (예: "reddit.com").company보다 우선 적용.company-- 회사명 (예: "Reddit"). 도메인이 제공되지 않으면 사용.- 이름 (다음 조합 중 하나 필수):
first_name+last_name(예: "Alexis" + "Ohanian")full_name(예: "Alexis Ohanian")
max_duration-- 최대 요청 지속 시간(초) (3-20, 기본값 10). 긴 시간일수록 더 정확한 결과.
3. 이메일 전달 가능성 확인
이메일 주소가 유효하고, 전달 가능하며, 발송해도 안전한지 확인합니다.
도구: HUNTER_EMAIL_VERIFIER
예시 프롬프트:
"[email protected]이 유효한 이메일 주소인지 확인해줘"
주요 매개변수:
email(필수) -- 확인할 이메일 주소 (예: "[email protected]")
응답 포함 사항: 확인 상태, 전달 가능성 점수, MX 레코드 검증, 위험 평가.
4. 이메일 볼륨 예측 확인
Hunter가 도메인이나 회사에 대해 보유한 이메일 주소 수를 확인하세요 -- 이 호출은 무료이며 API 크레딧을 소모하지 않습니다.
도구: HUNTER_EMAIL_COUNT
예시 프롬프트:
"Hunter가 stripe.com에 대해 몇 개의 이메일 주소를 가지고 있어?"
주요 매개변수:
domain-- 조회할 도메인 (예: "stripe.com").company가 제공되지 않으면 필수.company-- 회사명 (최소 3자).domain이 제공되지 않으면 필수.type-- "personal" 또는 "generic" 이메일로 개수 필터링
반환: 유형, 부서, 직급별 세분화된 총 개수.
5. 리드 저장 및 관리
단일 업서트 호출로 이메일별 리드를 생성하거나 업데이트하세요 -- 사전 존재 여부 확인이 필요 없습니다.
도구: HUNTER_UPSERT_LEAD
예시 프롬프트:
"[email protected]을 Hunter에 리드로 저장해줘, 이름 John Doe, 직위 CTO"
주요 매개변수:
email-- 리드의 이메일 주소 (업서트의 기본 식별자)- 이름, 직위, 회사 및 기타 리드 메타데이터
6. 계정 사용량 및 한도 확인
대량 작업을 실행하기 전에 Hunter 계정 플랜 세부 정보, 남은 검색 횟수, 확인 할당량을 확인합니다.
도구: HUNTER_ACCOUNT_INFORMATION
예시 프롬프트:
"이번 달에 Hunter API 검색이 몇 번 남았어?"
주요 매개변수: 없음.
알려진 문제점
- HTTP 401은 잘못된 자격 증명을 의미:
authentication_failed오류는 유효하지 않거나 만료된 API 키를 나타냅니다. 대량 작업 전에 먼저 해결하세요. - 이메일 개수는 추정치:
HUNTER_EMAIL_COUNT는 크기 조정 및 우선순위 지정을 위한 근사치를 반환하며, 보장된 검색 가능 이메일 수는 아닙니다. - 도메인 검색은 오프셋 페이지네이션 사용:
HUNTER_DOMAIN_SEARCH는limit/offset을 통해 페이지네이션합니다. 첫 번째 페이지가 완전하다고 가정하지 마세요 -- 결과가 비거나 한도에 도달할 때까지 계속 가져오세요. - 빈 결과는 오류가 아님:
HUNTER_DOMAIN_SEARCH는 오류 없이emails: []를 반환할 수 있습니다. "데이터 없음"으로 처리하고 계속 진행하며, 실패로 간주하고 재시도하지 마세요. - 확인 상태의 미묘함:
HUNTER_EMAIL_VERIFIER의accept_all또는risky상태는 불확실성을 나타냅니다. 엄격한 전달 가능성 워크플로에서 제외하거나 별도로 처리하세요. - 무료/기본 플랜 제한: 무료 및 기본 플랜은
HUNTER_DOMAIN_SEARCH의 요청당 결과를 10개로 제한합니다. 더 높은 한도는 유료 플랜이 필요합니다. - 도메인 형식 중요: "stripe.com"과 같이 베어 도메인을 사용하세요 -- 프로토콜("https://")이나 "www." 접두사를 포함하지 마세요.
빠른 참조
| 작업 | 도구 슬러그 | 필수 매개변수 |
|---|---|---|
| 도메인 이메일 검색 | HUNTER_DOMAIN_SEARCH | domain 또는 company |
| 개인 이메일 찾기 | HUNTER_EMAIL_FINDER | 이름 + (domain 또는 company) |
| 이메일 확인 | HUNTER_EMAIL_VERIFIER | email |
| 이메일 개수 조회 | HUNTER_EMAIL_COUNT | domain 또는 company |
| 리드 저장/업데이트 | HUNTER_UPSERT_LEAD | email |
| 계정 확인 | HUNTER_ACCOUNT_INFORMATION | 없음 |
Composio 제공