요약(TL;DR): Claude Code에서 에이전트를 활용해 리드 목록을 구축하려면 작업을 4개의 보드 태스크로 나누는 것이 좋습니다. Firecrawl Alexandria를 통한 무료 Apollo 인물 검색, 검색 결과로 반환된 필드를 바탕으로 진행하는 자격 검증(qualify), 선별된 대상에게만 수행하는 유료 People Data Labs 데이터 인리치먼트(enrichment), 그리고 아웃리치 전 사람의 최종 검토 단계입니다. 단 하나의 Firecrawl API 키로 모든 데이터 프로바이더를 사용할 수 있으며, 각 태스크별로 사용된 크레딧이 투명하게 기록됩니다.
Claude Code의 단일 세션에서 에이전트를 사용해 리드 목록을 한 번에 뽑아낼 수도 있습니다. “이 10개 기업의 엔지니어링 VP 명단과 업무용 이메일을 찾아줘”라고 요청하면 에이전트가 검색과 인리치먼트를 거쳐 CSV 파일로 전달해 주죠. 하지만 문제는 청구서를 받아 들었을 때 발생합니다. 직함만 보고도 바로 제외했을 사람들에게까지 에이전트가 유료 인리치먼트 비용을 써버린 것입니다.
Firecrawl Alexandria를 활용하면 '저비용 작업 우선' 원칙을 손쉽게 적용할 수 있습니다. 수백 개의 데이터 프로바이더를 단 하나의 Firecrawl API 키로 연동하며, 도구 탐색(discovery)은 무료이고 실행 시에만 각 툴에 책정된 크레딧이 차감되는 방식입니다. 이 글에서는 런타임으로 Claude Code 또는 Codex를 활용해 Sharkly의 태스크로 파이프라인을 구성하는 방법과 각 단계별 크레딧 비용을 살펴봅니다.
Firecrawl Alexandria가 리드 목록 생성 에이전트에 주는 이점
Firecrawl Alexandria는 에이전트가 하나의 Firecrawl 키로 호출할 수 있는 데이터 프로바이더 라이브러리입니다. Alexandria 페이지에는 430개의 프로바이더와 2,461개의 기능(capability)이 등록되어 있습니다. 에이전트는 무료로 적합한 도구를 탐색하고 입력값과 가격을 확인한 뒤, 웹페이지 스크래핑에 사용하는 것과 동일한 scrape 엔드포인트를 통해 실행할 수 있습니다.
리드 목록 작성 시 주목해야 할 핵심 카테고리는 바로 People입니다. 여기에는 인리치먼트를 위한 Apollo, People Data Labs, FullEnrich, Data Legion을 비롯해 제재 목록이나 미국 NPI 레지스트리 같은 공개 데이터 출처까지 총 12개의 프로바이더가 포함되어 있습니다. 이번 글에서는 그중 두 가지를 사용합니다.
| 프로바이더 | 기능(Capability) | 표기 가격 | 파이프라인 내 역할 |
|---|---|---|---|
| Apollo | people/search |
0 크레딧 | 타깃 도메인에서 직함별 인물 검색 |
| People Data Labs | person/enrich |
호출당 60 크레딧 | 자격 요건을 통과한 인물에 한해 프로필 상세 정보 보강 |
Alexandria의 Apollo 페이지에는 “Search-first prospect list(선검색 잠재고객 목록)”라는 기본 내장 스킬이 안내되어 있습니다. 이 스킬의 설명은 전체 전략을 한 문장으로 완벽히 요약합니다. 먼저 무료로 검색하고, 비용을 지불할 가치가 있는 인물만 추려낸 뒤, 비용 효율적인 순서대로 검증된 업무용 이메일을 찾는 것입니다. 아래의 태스크 보드는 이 전략을 담당자가 지정된 4개의 태스크로 구체화한 결과물입니다.
리드 목록 작성에 단일 프롬프트가 아닌 단계별 파이프라인이 필요한 이유
단일 세션에서는 비용에 결정적인 영향을 미치는 판단 과정, 즉 '유료 API 호출 전에 누구를 제외할 것인가'가 프롬프트 뒤로 숨어버립니다. Firecrawl의 가격 정책을 살펴보면 그 비용 차이가 얼마나 큰지 명확히 드러납니다.
예를 들어 10개 타깃 도메인에서 Apollo 검색 결과로 40명이 나왔다고 가정해 보겠습니다. 40명 전원을 호출당 60 크레딧으로 인리치먼트하면 총 2,400 크레딧이 들며, 이는 Free 플랜의 월간 제공량인 1,000 크레딧의 두 배가 넘는 수치입니다. 반면 직함 기반 검증을 거쳐 적합한 12명만 남긴다면 720 크레딧만 소요되어 Free 플랜 한도 내에서 충분히 해결됩니다.
제외 기준을 정하는 것은 비즈니스적 의사결정입니다. 예를 들어 “Head of Platform”이라는 직함을 구매 결정권자로 볼 것인지는 사람이 판단해야 합니다. 이 기준이 프롬프트 안에 묻혀 있으면 아무도 검토하지 못합니다. 하지만 담당자(Assignee)가 지정된 독립 태스크로 만들면 명확한 책임자, 진행 상태, 변경 이력이 남게 됩니다.
에이전트로 리드 목록을 구축하는 4단계 태스크
다음은 보드 태스크로 구성한 파이프라인입니다. 각 단계가 이전 단계의 완료를 기다리도록 차단함 / 차단됨(blocks / is blocked by) 관계로 연결합니다.
| 태스크 | 담당자(Assignee) | Firecrawl 비용 | 완료 조건 |
|---|---|---|---|
| 1. ICP를 Apollo 필터로 변환 + 인물 검색 | 에이전트 | 0 크레딧 | 인물 목록 저장 및 행 수 등록 |
| 2. 반환된 필드 기반 자격 검증 | 에이전트 | 0 크레딧 | 선별된 목록 및 제외 사유 등록 |
| 3. 선별 대상에 대한 People Data Labs 인리치먼트 | 에이전트 | 호출당 60 크레딧 | 인리치먼트된 행 등록 및 크레딧 사용량 보고 |
| 4. 아웃리치 전 최종 검토 | 사람(Person) | 0 크레딧 | 목록 승인, 수정 또는 반려 |
1단계: ICP를 무료 Apollo 검색 조건으로 변환하기
첫 번째 태스크는 이상적인 고객 프로필(ICP)을 Apollo 검색 입력값으로 변환하는 것입니다. 이 기능은 person_titles, q_keywords, q_organization_domains_list, page, per_page를 파라미터로 받으며, 페이지당 최대 100개의 결과를 반환합니다. Apollo 플레이그라운드에서 이 호출은 0 크레딧으로 표시됩니다.
도구 탐색 역시 무료입니다. 에이전트가 어떤 도구를 써야 할지 모른다면 sources: ["alexandria"]를 지정하여 Alexandria에 질의할 수 있습니다. Firecrawl 공식 문서에 따르면 출처에 "web"을 추가할 경우 유료 웹 검색 결과도 함께 반환되므로, 도구 탐색 시에는 Alexandria 도구만 조회하도록 유지해야 합니다.
# Free tool discovery: tools only, no paid web results
curl https://api.firecrawl.dev/v2/search \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "find people by job title at a company", "sources": ["alexandria"], "limit": 3}'
# Apollo people search at the target domains (listed at 0 credits)
curl https://api.firecrawl.dev/v2/scrape \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"alexandria": {
"provider": "apollo",
"capability": "people/search",
"options": {
"person_titles": ["VP of Engineering", "Head of Platform"],
"q_organization_domains_list": ["example-one.com", "example-two.com"],
"page": 1,
"per_page": 100
}
}
}'
결과값은 alexandria[0].data 아래에 저장됩니다. Firecrawl 문서에서는 도구 결과를 사용하기 전에 반드시 오류 여부를 확인하도록 권장하므로, 이를 태스크 완료 조건(Acceptance Criteria)에 포함시키는 것이 좋습니다. 즉, 에이전트가 반환된 행 수와 발생한 오류를 기록해야만 태스크가 완료된 것으로 처리합니다.
2단계: 검색 결과로 이미 확보된 필드를 활용한 자격 검증
자격 검증 태스크는 비용이 전혀 들지 않습니다. 검색 결과 데이터를 읽어 들인 뒤 이미 확보된 정보를 기준으로 부적합한 직함, 대상이 아닌 회사, 중복된 인물 등의 데이터를 제외합니다. 추가 API 호출은 발생하지 않습니다.
제외 규칙은 모든 에이전트가 참조할 수 있는 위치에 정의해야 합니다. Sharkly의 스킬(Skill)은 에이전트 작업에 필요한 재사용 가능한 지침을 패키징하므로, Sharkly의 스킬 가이드에 나온 것처럼 해당 규칙을 단일 스킬로 만들어 모든 리드 발굴 에이전트에 바인딩할 수 있습니다.
# lead-rules.md (owner: the person who approves the send)
keep_titles: ["VP of Engineering", "Head of Platform", "Director of Engineering"]
drop_if: [title_not_in_keep_titles, company_domain_not_in_list, duplicate_person]
max_enrich_calls_per_run: 15
pdl_min_likelihood: 6
every_task_reports: [rows_in, rows_out, credits_spent, errors]
3단계: 검증을 통과한 대상만 인리치먼트 진행
이 단계가 바로 유료 구간입니다. People Data Labs의 person/enrich 기능은 호출당 60 크레딧으로 책정되어 있습니다. 필수 입력값으로 pdl_id, email, 또는 email_hash 중 하나를 지원하며, 그 외 18개의 선택적 필드를 추가로 입력할 수 있습니다. 에이전트가 검색 필드를 인리치먼트 입력값에 매핑하기 전에 findTools로 전체 입력 규격을 먼저 확인하도록 설정하세요.
비용을 아끼는 가장 효과적인 설정값은 min_likelihood입니다. 이 값은 1부터 10까지 설정할 수 있으며 기본값은 2인데, Firecrawl에 따르면 이 수준에서는 실제 일치 확률이 10~30%에 불과합니다. 이 기준치를 높이면 일치도가 낮은 경우 404 에러를 반환하게 되는데, 프로바이더 페이지에서는 그 이점을 명확히 설명합니다. “여기서는 404가 무료이지만, 잘못된 레코드를 받아오는 것은 유료입니다.”
// One enrich call per qualified person; client set up with $FIRECRAWL_API_KEY
const result = await firecrawl.scrape({
alexandria: {
provider: "people-data-labs",
capability: "person/enrich",
options: {
email: person.email, // or pdl_id / email_hash
min_likelihood: 6, // weak matches 404 instead of billing a wrong record
titlecase: true,
},
},
});
const record = result.alexandria[0];
if (record.error) report.errors.push(record.error);
People Data Labs는 Alexandria를 통해 고객 조직당 연간 50,000회의 API 호출 쿼터를 제공하며, 이는 개인(person) 및 기업(company) 엔드포인트에 통합 적용됩니다. 재시도 횟수도 포함되며 매년 1월 1일(UTC 기준)에 리셋됩니다. 규칙 파일에서 실행당 인리치먼트 호출 횟수에 상한선을 두어야 하는 또 다른 이유입니다.
호출이 THIRD_PARTY_DATA_TERMS_REQUIRED 오류로 실패하면 응답에 requiresAction.url이 포함됩니다. 조직 관리자가 해당 URL에서 프로바이더의 약관에 동의해야 하며, Firecrawl 문서에 따르면 에이전트가 약관에 동의하기 전에 반드시 사용자의 명시적인 승인을 받아야 합니다. 이를 사람에게 작업을 넘기는 핸드오프 단계로 처리하여, 에이전트가 해당 태스크를 '사용자 답변 대기(waiting for a human reply)' 상태로 전환하도록 만듭니다.
4단계: 아웃리치 전 담당자의 최종 검토
마지막 태스크는 사람의 몫입니다. 에이전트가 인리치먼트된 목록을 첨부한 뒤 태스크를 사람 검토 대기(waiting for human review) 상태로 둡니다. 검토자는 공개 프로필과 대조하여 샘플을 확인하고, 연락해서는 안 되는 인물을 삭제한 후 최종 승인합니다.
이는 인간 참여형(Human-in-the-loop) 코딩 에이전트에서 설명했던 검증 게이트와 동일합니다. 목록 자체는 데이터일 뿐이지만, 누군가에게 직접 연락하는 것은 사람이 최종 결정하고 서명해야 할 비즈니스 행위입니다.
단계별 크레딧 영수증
10개 타깃 도메인에서 40명을 찾고 그중 12명이 자격을 통과했을 때, 정가 기준으로 산출된 비용 영수증은 다음과 같습니다.
| 단계 | 호출 횟수 | 크레딧 |
|---|---|---|
| 도구 탐색 | 1 | 0 |
Apollo people/search |
1 | 0 |
| 자격 검증 | 0 | 0 |
People Data Labs person/enrich |
12 | 720 |
| 총계 | 14 | 720 |
크레딧을 실제 달러 비용으로 환산하는 것은 이용 중인 요금제에 따라 달라지므로, 대략 넘기지 말고 직접 계산해 보는 것이 좋습니다. 월간 청구 기준 Firecrawl 요금제에서 Hobby 플랜은 5,000 크레딧에 19달러(크레딧당 0.0038달러)이므로, 720 크레딧은 플랜 기준 약 2.74달러에 해당합니다. Standard 플랜은 100,000 크레딧에 99달러(크레딧당 0.00099달러)이므로 동일한 작업이 약 0.71달러에 불과합니다. 또한 매월 1,000 크레딧이 주어지는 Free 플랜이라면 0달러로 모두 해결할 수 있습니다.
만약 자격 검증 단계를 거치지 않았다면 동일한 작업에 2,400 크레딧이 소요됩니다. 이는 Hobby 플랜 기준 약 9.12달러에 달하며, Free 플랜의 제공 한도를 초과합니다. 즉, 자격 검증 태스크는 영수증에서 비용이 전혀 들지 않으면서도 가장 큰 금액을 절감해 주는 핵심 단계입니다.
Sharkly가 파이프라인의 투명성과 통제력을 유지하는 방법
API 호출 자체는 Claude Code나 Codex가 수행하지만, 그 전후의 워크플로우를 체계적으로 관리하는 것은 Sharkly의 몫입니다.
- 담당자(Assignee)가 지정된 태스크: 에이전트, 크루(Crew), 또는 사람에 상관없이 각 단계마다 명확한 상태와 담당자가 부여됩니다.
- 태스크 본문에 API 키를 노출하지 않음: Computer & Runtime 설정 아래의 에이전트 환경 변수(Environment Variables)에
FIRECRAWL_API_KEY를 설정하면 에이전트 프로세스가 시작될 때 안전하게 주입됩니다. Sharkly에서는 이 값이 비밀 저장소가 아닌 에이전트 관리자가 볼 수 있는 일반 텍스트 설정으로 분류되므로, 이 작업 전용으로 권한이 제한된 키를 사용하는 것이 좋습니다. - 검토 상태 관리: 에이전트는 태스크를 '사용자 답변 대기' 또는 '사람 검토 대기' 상태로 둘 수 있으며, 이는 담당자의 받은편지함(Inbox)으로 바로 전달됩니다.
- 실행 기록(Run record): 실행마다 시작 및 종료 시점, 도구 호출, 실패 세부 정보가 기록되므로 크레딧 사용 보고서의 근거가 명확히 남습니다.
4개의 태스크를 일일이 수동으로 만들고 싶지 않다면 Sharkly Crews에서 다룬 것처럼 크루 리더(Crew leader)가 상위 태스크를 하위 단계로 자동 분할하도록 설정할 수도 있습니다. Sharkly는 무료로 시작할 수 있으며, 모델 사용량은 런타임에 연결된 Claude Code 또는 Codex 플랜을 따릅니다.
실행은 스케줄로 자동화하되, 검토는 수동으로 유지하기
4개의 태스크가 일주일간 문제없이 안정적으로 동작한다면 1~3번 태스크를 자동화(Automation)로 설정하여 새 도메인 목록이 들어올 때마다 무료 검색과 상한선이 적용된 인리치먼트가 자동 실행되도록 하세요. 4번 태스크는 계속 수동 검토로 유지합니다. 이러한 실행 작업을 여러 개 동시에 모니터링하는 방법은 병렬 실행 중인 코딩 에이전트를 모니터링하는 방법을 참고하세요.
무료 단계부터 시작해 보세요
Apollo 스킬이 제시하는 방식대로 에이전트를 활용해 리드 목록을 구축해 보세요. 무료로 검색하고, 이미 확보한 데이터로 자격을 검증하며, 선별된 대상에 대해서만 비용을 지불하고, 누군가에게 연락하기 전에 반드시 사람의 검토를 거치는 것입니다. Sharkly에서 1번과 2번 태스크부터 시작해 보세요. 크레딧 비용이 전혀 들지 않으면서도 유료 단계에서 지출될 비용을 미리 가늠할 수 있습니다.
자주 묻는 질문(FAQ)
Firecrawl Alexandria란 무엇인가요?
에이전트가 단 하나의 Firecrawl API 키로 호출할 수 있는 데이터 프로바이더 라이브러리입니다. 도구 탐색은 무료이며, 각 도구마다 실행에 필요한 크레딧 가격이 표기되어 있습니다. Firecrawl은 2026년 9월 22일에 이를 출시했습니다.
Firecrawl을 통한 Apollo 인물 검색은 무료인가요?
Apollo의 people/search 기능은 Firecrawl 플레이그라운드에서 0 크레딧으로 표시됩니다. 다만 연락처 세부 정보를 확인하는 것은 별도의 유료 단계이므로, 실행 전에 해당 기능의 표기 가격을 반드시 확인하시기 바랍니다.
Firecrawl에서 People Data Labs 인리치먼트 비용은 얼마인가요?
person/enrich 기능은 호출당 60 크레딧으로 책정되어 있습니다. 월간 청구 기준 Hobby 플랜에서는 약 0.23달러, Standard 플랜에서는 약 0.06달러 수준입니다. min_likelihood 값을 높여 발생하는 404 에러에는 비용이 전혀 청구되지 않습니다.
Claude Code 대신 Codex를 사용해도 되나요?
네, 가능합니다. Firecrawl은 CLI, SDK 및 firecrawl_search, firecrawl_find_tools, firecrawl_scrape를 제공하는 MCP 서버를 지원하며, Sharkly 에이전트는 두 런타임 모두에서 원활히 작동합니다. 전반적인 설정 방법은 AI 태스크 매니저: 에이전트 작업 할당, 추적 및 검토를 참고하세요.
에이전트가 목록을 바탕으로 아웃리치를 직접 발송해도 되나요?
권장하지 않습니다. 발송 단계 전에는 반드시 사람의 검토 태스크를 두어야 합니다. 에이전트의 역할은 검증된 목록 작성과 크레딧 사용량 보고서 제공까지입니다.
