TL;DR: Para criar uma lista de leads com agentes no Claude Code, divida o trabalho em quatro tarefas no quadro: uma busca gratuita de pessoas no Apollo via Firecrawl Alexandria, uma etapa de qualificação com base nos campos já retornados pela busca, um enriquecimento pago no People Data Labs apenas para os perfis aprovados e uma revisão humana antes de qualquer abordagem. Uma única chave do Firecrawl cobre todos os provedores, e cada tarefa informa exatamente o que gastou.
É possível criar uma lista de leads com agentes em uma única sessão longa do Claude Code. Você pede os “VPs de Engenharia destas dez empresas, com e-mails corporativos”, e o agente busca, enriquece e entrega um arquivo CSV. O problema aparece na fatura: o agente pagou para enriquecer pessoas que você teria descartado apenas pelo cargo.
O Firecrawl Alexandria facilita priorizar as etapas mais econômicas. Ele reúne centenas de provedores de dados sob uma única chave de API do Firecrawl, seguindo a regra de que a descoberta é gratuita, enquanto a execução consome os créditos indicados para cada ferramenta. Este post estrutura esse pipeline em tarefas no Sharkly, usando o Claude Code ou o Codex como runtime, e mostra o custo em créditos de cada etapa.
O que o Firecrawl Alexandria oferece a um agente de geração de leads
O Firecrawl Alexandria é uma biblioteca de provedores de dados que um agente pode consultar por meio de uma única chave do Firecrawl. A página do Alexandria lista 430 provedores e 2.461 funcionalidades. O agente descobre ferramentas gratuitamente, lê suas entradas e preços e, em seguida, as executa pelo mesmo endpoint scrape utilizado para páginas web.
Para listas de leads, a categoria People é a que realmente importa. Ela conta com 12 provedores, incluindo Apollo, People Data Labs, FullEnrich e Data Legion para enriquecimento, além de fontes públicas como listas de sanções e o NPI Registry. Este post utiliza dois deles:
| Provedor | Funcionalidade | Preço tabelado | Função no pipeline |
|---|---|---|---|
| Apollo | people/search |
0 créditos | Encontrar pessoas por cargo nos domínios-alvo |
| People Data Labs | person/enrich |
60 créditos por chamada | Preencher campos de perfil apenas para pessoas qualificadas |
A própria página do Apollo no Alexandria inclui uma habilidade nativa chamada “Search-first prospect list”. Sua descrição resume toda a estratégia em uma única linha: busque gratuitamente primeiro, revele apenas os contatos que realmente valem a pena e, por fim, encontre e-mails de trabalho verificados em ordem de custo. O quadro abaixo transforma essa premissa em quatro tarefas com responsáveis definidos.
Por que uma lista de leads precisa de etapas, não de um único prompt
Uma única sessão oculta a decisão que realmente determina os custos: quem é descartado antes da chamada paga. Os preços do Firecrawl deixam essa diferença bem evidente.
Suponha que o Apollo retorne 40 pessoas nos seus dez domínios. Enriquecer todas elas a 60 créditos cada custa 2.400 créditos — mais que o dobro dos 1.000 créditos mensais do plano Free. Se uma triagem por cargo mantiver 12 pessoas, o enriquecimento custará 720 créditos e caberá com folga no plano Free.
Essa regra de descarte é uma decisão de negócio. Alguém precisa definir se um “Head of Platform” é um comprador em potencial. Quando essa lógica fica oculta em um prompt, ninguém a revisa. Quando é estruturada como uma tarefa com um responsável (Assignee), ela ganha dono, status e um histórico de alterações.
Como criar uma lista de leads com agentes: as quatro tarefas
Aqui está o pipeline estruturado em tarefas no quadro. Vincule-as com bloqueia / é bloqueada por para que cada etapa aguarde a conclusão da anterior.
| Tarefa | Responsável | Custo no Firecrawl | Concluída quando |
|---|---|---|---|
| 1. ICP para filtros do Apollo + busca de pessoas | Agente | 0 créditos | Lista de pessoas salva e contagem de linhas informada |
| 2. Qualificação com base nos campos retornados | Agente | 0 créditos | Perfis aprovados e motivos de descarte informados |
| 3. Enriquecimento dos aprovados no People Data Labs | Agente | 60 créditos por chamada | Linhas enriquecidas postadas e créditos gastos informados |
| 4. Revisão antes da abordagem | Pessoa | 0 créditos | Lista aprovada, editada ou devolvida |
Etapa 1: Transforme o ICP em uma busca gratuita no Apollo
A primeira tarefa converte o seu perfil de cliente ideal (ICP) nos parâmetros de busca do Apollo. A funcionalidade aceita person_titles, q_keywords, q_organization_domains_list, page e per_page, com um limite de 100 resultados por página. O playground do Apollo indica essa chamada como 0 créditos.
A descoberta também é gratuita. Se o agente não souber qual ferramenta utilizar, ele consulta o Alexandria com sources: ["alexandria"]. A documentação do Firecrawl alerta que adicionar "web" às fontes também trará resultados pagos da web; por isso, restrinja a busca apenas a ferramentas.
# 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
}
}
}'
O resultado fica disponível em alexandria[0].data. A documentação do Firecrawl recomenda verificar se houve erros no resultado de cada ferramenta antes de usá-lo; por isso, inclua isso nos critérios de aceitação: a tarefa só termina quando o agente informar a contagem de linhas e eventuais erros encontrados.
Etapa 2: Qualifique com base nos campos já retornados pela busca
A tarefa de qualificação não custa nada. Ela lê o retorno da busca e descarta registros com base nos dados que já estão em mãos: cargo incorreto, empresa divergente ou pessoa duplicada. Nenhuma chamada adicional é feita.
Coloque as regras de descarte onde todos os agentes possam lê-las. Uma Skill do Sharkly empacota instruções reutilizáveis para o trabalho dos agentes; assim, as regras se tornam uma única Skill vinculada a todos os agentes da lista de leads, como descrito em Skills no 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]
Etapa 3: Enriqueça apenas os perfis aprovados
Esta é a etapa paga. A funcionalidade person/enrich do People Data Labs está listada a 60 créditos por chamada. Ela aceita um pdl_id, um email ou um email_hash como entradas suficientes, além de outros 18 campos opcionais. Faça o agente consultar o contrato de entrada completo com findTools antes de mapear os campos da busca para as entradas de enriquecimento.
O ajuste mais econômico é o min_likelihood. Ele varia de 1 a 10 e tem valor padrão 2, nível no qual o Firecrawl indica que a correspondência tem apenas de 10% a 30% de chance de ser a pessoa certa. Aumentar esse valor transforma correspondências fracas em um 404, e a página do provedor é direta sobre por que isso ajuda: “um 404 é gratuito aqui, mas um registro incorreto não é”.
// 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);
O People Data Labs também impõe uma cota no Alexandria: 50.000 chamadas de API por ano por organização de cliente, compartilhadas entre os endpoints de pessoas e empresas. Tentativas adicionais contam para o limite, e a cota é zerada em 1º de janeiro (UTC). Esse é mais um motivo para limitar as chamadas de enriquecimento por execução no arquivo de regras.
Se uma chamada falhar com THIRD_PARTY_DATA_TERMS_REQUIRED, a resposta incluirá uma requiresAction.url. Um administrador da organização precisa aceitar os termos do provedor nesse endereço, e a documentação do Firecrawl especifica que os agentes precisam de autorização explícita do usuário antes de aceitar termos. Trate isso como uma transição: o agente deixa a tarefa aguardando uma resposta humana.
Etapa 4: Uma pessoa revisa antes da abordagem
A última tarefa cabe a uma pessoa. O agente anexa a lista enriquecida e deixa a tarefa aguardando revisão humana. O revisor confere uma amostragem com base em perfis públicos, remove quem não deve ser contatado e aprova.
Esse é o mesmo controle de validação que descrevemos em agentes de codificação com humanos no circuito. A lista é apenas dado; entrar em contato com alguém é uma decisão que exige o aval de uma pessoa.
O demonstrativo de créditos por etapa
Com 10 domínios-alvo, 40 pessoas encontradas e 12 qualificadas, os preços tabelados geram o seguinte balanço:
| Etapa | Chamadas | Créditos |
|---|---|---|
| Descoberta de ferramentas | 1 | 0 |
Apollo people/search |
1 | 0 |
| Qualificação | 0 | 0 |
People Data Labs person/enrich |
12 | 720 |
| Total | 14 | 720 |
A conversão de créditos em dólares depende do plano, então vale a pena fazer as contas em vez de arredondar. Na tabela de preços do Firecrawl, com faturamento mensal, o plano Hobby custa US$ 19 por 5.000 créditos, o que dá US$ 0,0038 por crédito; portanto, 720 créditos equivalem a cerca de US$ 2,74 em créditos do plano. O Standard custa US$ 99 por 100.000 créditos, ou US$ 0,00099 por crédito, fazendo com que a mesma execução custe cerca de US$ 0,71. Já os 1.000 créditos mensais do plano Free cobrem o processo a US$ 0.
Sem a etapa de qualificação, a mesma execução consumiria 2.400 créditos: cerca de US$ 9,12 no Hobby e mais do que o limite do plano Free. A tarefa de qualificação é a linha mais barata do demonstrativo e a que gera a maior economia.
Como o Sharkly garante a integridade do pipeline
O Claude Code ou o Codex faz as chamadas. O Sharkly gerencia o fluxo de trabalho ao redor delas.
- Tarefas com responsáveis (Assignees). Cada etapa tem um status e um responsável, seja um Agente, uma Equipe (Crew) ou uma pessoa.
- A chave não fica exposta no texto da tarefa. Defina
FIRECRAWL_API_KEYnas Variáveis de Ambiente do Agente, em Computer & Runtime, e ela será injetada quando o processo do agente iniciar. O Sharkly identifica esses valores como configurações em texto simples visíveis aos gestores de agentes, e não como cofre de segredos; portanto, utilize uma chave com permissões restritas a essa função. - Status de revisão. O Agente pode deixar uma tarefa aguardando resposta ou revisão humana, o que é direcionado diretamente para a Caixa de Entrada da pessoa responsável.
- Histórico de execução. Cada execução exibe início e fim, chamadas de ferramentas e detalhes de eventuais falhas, garantindo rastreabilidade total para o relatório de créditos.
Se preferir não criar as quatro tarefas manualmente, um líder de Crew pode dividir uma tarefa principal nas etapas necessárias, conforme abordado em Sharkly Crews. O Sharkly é gratuito para começar, e o consumo do modelo utiliza o plano do Claude Code ou Codex associado ao seu Runtime.
Execute de forma programada, mantenha a revisão manual
Assim que as quatro tarefas rodarem perfeitamente por uma semana, configure as tarefas de 1 a 3 em uma Automação, de modo que uma nova lista de domínios acione a busca gratuita e o enriquecimento controlado. A tarefa 4 permanece manual. Para acompanhar várias dessas execuções simultaneamente, consulte como monitorar agentes de codificação em execução paralela.
Comece pelas etapas gratuitas
Crie uma lista de leads com agentes da maneira descrita pela habilidade do Apollo: busque de graça, qualifique com os dados que já tem, pague apenas pelos perfis aprovados e inclua uma pessoa para revisar a lista antes de contatar qualquer contato. Comece pelas tarefas 1 e 2 no Sharkly. Elas custam 0 créditos e mostram exatamente quanto a etapa paga consumiria.
FAQ
O que é o Firecrawl Alexandria?
Uma biblioteca de provedores de dados que agentes consultam por meio de uma única chave de API do Firecrawl. A descoberta é gratuita, e cada ferramenta informa seu próprio preço em créditos para execução. O Firecrawl fez o lançamento em 22 de setembro de 2026.
A busca de pessoas do Apollo é gratuita pelo Firecrawl?
A funcionalidade people/search do Apollo aparece com 0 créditos no playground do Firecrawl. A revelação de detalhes de contato é uma etapa paga e separada; portanto, confira o preço indicado dessa funcionalidade antes de executá-la.
Quanto custa o enriquecimento do People Data Labs no Firecrawl?
A funcionalidade person/enrich está tabelada em 60 créditos por chamada. Isso equivale a cerca de US$ 0,23 no plano Hobby e US$ 0,06 no Standard, com faturamento mensal. Um erro 404 decorrente do aumento do min_likelihood não tem custo.
Isso funciona com o Codex em vez do Claude Code?
Sim. O Firecrawl disponibiliza uma CLI, SDKs e um servidor MCP com firecrawl_search, firecrawl_find_tools e firecrawl_scrape, e um Agente do Sharkly pode rodar em qualquer um dos dois Runtimes. A configuração geral está descrita em Gerenciador de tarefas com IA: atribua, acompanhe e revise o trabalho de agentes.
O agente deve fazer a abordagem dos contatos por conta própria?
Não. Mantenha o envio condicionado a uma tarefa de revisão humana. O papel do agente termina na entrega de uma lista verificada e do relatório de créditos.
