O que é Firecrawl Alexandria? Uma única chave de API para Apollo, People Data Labs e 430 provedores

O Firecrawl Alexandria é uma biblioteca de 430 provedores de dados e 2.461 capacidades que o seu agente de IA acessa com a mesma chave de API do Firecrawl que já usa para pesquisa e scraping. A sua categoria People contém 12 provedores, incluindo Apollo, People Data Labs e FullEnrich. A descoberta é gratuita; executar uma ferramenta de provedor custa os créditos listados nela.

Este guia aborda o que está na categoria People, como funciona o ciclo de pesquisa, find-tools e scrape, quanto custam as chamadas e como o seu agente de programação pode protegê-las com uma suíte de regressão do Apidog CLI.

O que é o Firecrawl Alexandria?

O Firecrawl Alexandria é um catálogo de provedores de dados oficiais, conectores personalizados e os próprios índices do Firecrawl que fica por trás da API do Firecrawl. Um agente descreve o que precisa, recebe ferramentas classificadas junto aos resultados da web, inspeciona as entradas e o preço de uma ferramenta e depois a executa pelo endpoint de scrape. Uma única chave cobre a web ao vivo e todos os provedores.

O Firecrawl o lançou em 22 de setembro de 2026, no mesmo anúncio da sua Série B de US$ 75 milhões, liderada pela Smash Capital com Altos Ventures, Nexus Venture Partners, Y Combinator, Freestyle e Offline Ventures. O Firecrawl afirma que já paga alguns provedores, entre eles a Wikimedia Enterprise.

Os números na página do Alexandria em 3 de novembro de 2026:

Métrica	Valor
Provedores	430
Capacidades	2.461
Categorias	20
Fontes indexadas	113M+ artigos, READMEs, issues e docs
Provedores de People	12

O Alexandria também inclui três índices operados pelo Firecrawl. O Developer Index pesquisa documentação, repositórios, issues e habilidades de agentes. O Research Index encontra artigos científicos e segue citações. O Government & Legal Index cobre leis, regulamentos e ordenanças. Se você usou o Firecrawl apenas para transformar páginas em markdown, o Alexandria alcança dados que um scraper não consegue obter de uma página.

O que a categoria People contém

A categoria People coloca enriquecimento de nível comercial e registros públicos por trás de uma única chave. Ela lista 12 provedores:

Infográfico dos 12 provedores na categoria People do Firecrawl Alexandria, agrupados como enriquecimento comercial (Apollo, FullEnrich, People Data Labs, Data Legion), mídia (Particle) e registros públicos (OpenSanctions, UK Sanctions List, NPI Registry, US Senate eFD, U.S. House Clerk, New Jersey DCA licenses, City of Seattle)

Enriquecimento comercial (4):

Apollo: encontre pessoas por cargo e empresa, resolva-as para e-mails de trabalho verificados, enriqueça empresas a partir de um domínio. 10 capacidades.
People Data Labs: resolução de identidade de pessoas e empresas, enriquecimento e pesquisa a partir de um perfil, e-mail, domínio, ticker ou nome.
FullEnrich: pesquisa de pessoas e empresas, consultas de perfis, firmográficos e dados de contato verificados.
Data Legion: enriquecimento de pessoas e empresas.

Mídia (1):

Particle: inteligência de podcasts, incluindo as pessoas que aparecem nos programas.

Registros públicos (7):

OpenSanctions: pesquisa de sanções, PEP e pessoas de interesse.
UK Sanctions List (FCDO): cerca de 6.400 designações em 31 regimes.
NPI Registry: identidades de provedores de saúde do CMS e locais de atendimento.
Divulgações financeiras do Senado dos EUA (eFD): cada chamada exige o reconhecimento das restrições legais de uso.
U.S. House Clerk: votações nominais e a lista atual de membros.
Verificação de licenças de Nova Jersey (DCA): pesquisa de licenciados e registros de licenças.
City of Seattle: lista do conselho e consulta por distrito.

Dois detalhes importam antes de você conectar isso a um agente. O People Data Labs tem uma cota de 50.000 chamadas de API por ano por organização cliente, compartilhada entre os endpoints de pessoa e empresa, contando retentativas, e reiniciando em 1º de janeiro UTC. E o Apollo vem com 27 habilidades prontas, como "Lista de prospects com pesquisa primeiro", que pesquisa gratuitamente primeiro e paga apenas para revelar pessoas que vale a pena contatar.

Como o Firecrawl Alexandria funciona: search, find-tools, scrape

Toda chamada ao Alexandria segue os mesmos três passos, de acordo com a documentação do Alexandria:

Descobrir. Chame search com sources: ["alexandria"] e uma consulta em linguagem natural. Você recebe ferramentas classificadas, cada uma com um provedor, capacidade e descrição.
Inspecionar. Chame find-tools para ler as entradas, o contrato de resposta e o preço de uma ferramenta.
Executar. Chame scrape com um objeto alexandria nomeando o provedor, a capacidade e as opções. Nenhuma URL de página é necessária.

Diagrama de fluxo de uma chamada ao Firecrawl Alexandria: um agente de programação com FIRECRAWL_API_KEY executa uma pesquisa de descoberta gratuita, uma inspeção find-tools gratuita e depois uma chamada de scrape paga que alcança provedores como Apollo e People Data Labs

Aqui está a chamada de descoberta via HTTP bruto:

curl -s https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find VP of Sales at a SaaS company", "sources": ["alexandria"], "limit": 5}'

Use ["web", "alexandria"] quando você também quiser páginas, mas note que os resultados da web são pagos; a descoberta apenas de ferramentas é gratuita.

E aqui está a execução, usando a capacidade people/search do Apollo:

curl -s 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 Sales"],
        "q_organization_domains_list": ["stripe.com"],
        "page": 1,
        "per_page": 25
      }
    }
  }'

O SDK retorna os resultados em alexandria[], com o payload sob data; o HTTP bruto envolve todo esse resultado em mais um campo data. Verifique cada resultado em busca de erro antes de usá-lo. No Node, a mesma chamada é firecrawl.scrape({ alexandria: {...} }), e em Python é firecrawl.scrape(alexandria={...}).

Em um terminal, o Firecrawl CLI faz o mesmo ciclo:

npm install -g firecrawl-cli
firecrawl login
firecrawl search "work email for a VP of Sales" --sources web,alexandria --domain-tools --limit 2
firecrawl find-tools --options '{"providers":["apollo"],"level":"tools","expand":["options","response"]}' --include-costs
firecrawl scrape apollo/people/search --options '{"person_titles":["VP of Sales"],"per_page":10}'

Via MCP, o mesmo ciclo é firecrawl_search, firecrawl_find_tools e firecrawl_scrape. Nosso guia do Firecrawl CLI e o tutorial do Firecrawl MCP cobrem ambas as configurações.

Uma barreira aparece nas primeiras execuções: alguns provedores retornam THIRD_PARTY_DATA_TERMS_REQUIRED com um requiresAction.url, e um administrador da organização precisa aceitar os termos desse provedor antes que a chamada funcione.

Preços do Firecrawl Alexandria em créditos

O Alexandria usa o mesmo saldo de créditos que o resto do Firecrawl. As regras da documentação:

A descoberta é gratuita. A pesquisa com sources: ["alexandria"] e o find-tools não custam nada.
A execução custa o preço listado da ferramenta. Ele é mostrado em cada página de provedor ao lado do botão Run.
Os índices Government e Research são gratuitos com um limite diário de chamadas definido pelo seu plano; Scale e Enterprise são ilimitados.
O feedback reembolsa 1 crédito. Envie-o dentro de 20 minutos após a última chamada do Alexandria da sua equipe ou ele falha com FEEDBACK_WINDOW_EXPIRED. Os reembolsos são limitados a 10 créditos por site e 100 por equipe por dia UTC.

Em 3 de novembro de 2026, as páginas dos provedores mostravam dois preços: o people/search do Apollo mostrava 0 créditos, e o person/enrich do People Data Labs mostrava 60 créditos por chamada. Para o Apollo, a etapa paga é revelar e-mails, então verifique essas capacidades com find-tools --include-costs antes de fazer um loop sobre uma lista.

Quanto custa um crédito em dólares? Aqui está o cálculo da página de preços do Firecrawl, cobrança mensal:

Plano	Preço	Créditos/mês	Custo por crédito	Um enrich do PDL (60 créditos)
Free	$0, sem cartão	1.000	$0	16 chamadas cabem na concessão mensal
Hobby	$19	5.000	$0,0038	$0,228
Standard	$99	100.000	$0,00099	$0,0594
Growth	$399	500.000	$0,000798	$0,0479
Scale	$749	1.000.000	$0,000749	$0,0449

Os planos pagos adicionam créditos em incrementos de US$ 5 (1.000 no Hobby, 2.000 no Standard). Enriquecer 500 contatos pelo PDL são 30.000 créditos, o que te coloca no Standard.

A entrada min_likelihood do PDL (1 a 10, padrão 2) recusa correspondências fracas, e segundo a página do provedor, um 404 "é gratuito aqui e um registro errado não é". Aumente-o para economizar créditos e linhas ruins.

O que o Alexandria não é

Ajuda descartar coisas:

Não é um scraper. As ferramentas do Alexandria chamam APIs oficiais, registros e conectores. O scraping continua sendo o endpoint de scrape do Firecrawl, que nossa compilação de APIs de web scraping compara com outras opções.
Não é um CRM. Ele retorna dados; armazenar, deduplicar e sincronizar contatos é trabalho seu ou do seu CRM.
Não é um benchmark independente. O Firecrawl relata que agentes usando o Alexandria pontuaram 21% mais alto em qualidade de resposta do que ferramentas da web integradas em 845 tarefas, com o mesmo modelo e prompts, julgadas às cegas por uma IA. Esse é o próprio teste do Firecrawl, então trate-o como uma afirmação a ser verificada na sua carga de trabalho.
Não é uma ferramenta de conformidade. A própria listagem de sanções do Reino Unido afirma que uma correspondência ou uma ausência não é uma determinação de conformidade.

Deixe seu agente de programação testar o Alexandria com o Apidog CLI

Depois que um fluxo de trabalho depende de apollo/people/search, você quer saber quando uma entrada é renomeada ou um resultado começa a retornar erro. Seu agente pode detectar isso com uma suíte de regressão no Apidog CLI; você escreve um único prompt.

Configure o CLI e sua habilidade de agente uma vez:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code, Codex or Cursor when prompted

Então dê ao seu agente este prompt:

Write an OpenAPI 3 file for two Firecrawl calls: POST /v2/search with
sources ["alexandria"], and POST /v2/scrape with an alexandria object for
provider "apollo", capability "people/search", per_page 5. Both send
Authorization: Bearer {{FIRECRAWL_API_KEY}}. Import it into Apidog project
<projectId>, create a "Firecrawl" environment with base URL
https://api.firecrawl.dev, and create a test case per endpoint that asserts
status 200, at least one returned tool on search, and on scrape that
data.alexandria[0].data exists with no error. Run both and summarize failures.

O agente lê cada esquema de payload, valida seu JSON e então executa comandos como estes:

apidog import --project <projectId> --format openapi --file ./firecrawl-alexandria.json
apidog environment create Firecrawl --project <projectId> --base-url https://api.firecrawl.dev
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file ./apollo-search-case.json
apidog test-case create --project <projectId> --file ./apollo-search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY" -r cli,junit

A escolha das chamadas mantém a suíte barata: a descoberta apenas de ferramentas é gratuita, e a pesquisa do Apollo mostrava 0 créditos em 3 de novembro. Mantenha capacidades pagas, como o enrich do PDL de 60 créditos, fora da execução agendada, ou execute-as semanalmente com uma entrada de teste conhecida. A mesma linha apidog run ... -r junit se encaixa em um pipeline; o guia do Apidog CLI para CI/CD tem exemplos de GitHub Actions e GitLab, e o Apidog CLI no Claude Code cobre a configuração do agente. O plano gratuito do Apidog cobre até 4 usuários.

Conclusão

O Firecrawl Alexandria transforma uma única chave em acesso a 430 provedores, com Apollo, People Data Labs e mais dez fontes de People por trás das mesmas três chamadas. A descoberta é gratuita, a execução tem um preço listado, e os 1.000 créditos do plano gratuito são suficientes para testar a adequação. Verifique primeiro os termos dos provedores, mantenha o min_likelihood alto e deixe seu agente proteger as chamadas com o Apidog CLI.

FAQ

O Firecrawl Alexandria é gratuito? A descoberta é. A pesquisa com sources: ["alexandria"] e o find-tools não custam créditos, e os índices Government e Research são gratuitos até um limite diário. As ferramentas de provedores custam os créditos listados, debitados do seu plano, que começa com 1.000 créditos gratuitos por mês e sem cartão.

Preciso de contas separadas da Apollo ou do People Data Labs? Não. O Firecrawl afirma que todos os provedores de People podem ser chamados com a mesma chave de API do Firecrawl. Alguns provedores exigem que um administrador da organização aceite seus termos primeiro, sinalizado por um erro THIRD_PARTY_DATA_TERMS_REQUIRED.

Quanto custa uma consulta ao People Data Labs pelo Alexandria? A capacidade person/enrich mostrava 60 créditos por chamada em 3 de novembro de 2026. Isso dá cerca de US$ 0,23 no Hobby e US$ 0,06 no Standard nos preços mensais. O PDL também tem uma cota anual de 50.000 chamadas por organização.

O Claude Code ou o Codex podem usar o Alexandria? Sim. Instale o Firecrawl CLI ou conecte o servidor Firecrawl MCP, e o agente terá acesso a search, find-tools e scrape.

O ganho de 21% em qualidade de resposta é independente? Não. É o próprio teste do Firecrawl: 845 tarefas, mesmo modelo e prompts, julgamento cego por IA. Faça sua própria comparação antes de confiar nele.