O Cadastro de agente permite que agentes de IA criem chaves de API do Firecrawl programaticamente — sem navegador, sem OAuth e sem humano no momento da criação. O agente fornece o email de um humano, e o Firecrawl provisiona uma chave de API em sandbox que funciona imediatamente, com um limite de 50 créditos. O humano recebe um email para confirmar ou bloquear a chave.
Não é necessária autenticação. O endpoint /agent-signup é público. Os agentes não precisam de uma chave de API existente para chamá-lo.
- O agente faz a chamada
POST /v2/agent-signup com o email do usuário, o nome do agente e accept_terms: true.
- O Firecrawl retorna uma API key imediatamente. A chave fica em sandbox com 50 credits e limitada a scraping apenas de indexação até que o patrocinador confirme.
- A pessoa recebe um email com dois links: Confirmar & Vincular chave ou Bloquear esta chave.
- Após a confirmação, a chave em sandbox é mesclada à conta existente da pessoa no Firecrawl (ou uma nova conta é criada). A chave herda os limites completos do plano.
- Em caso de bloqueio, a chave é desativada e o email fica protegido contra futuros cadastros não autorizados.
Agent Firecrawl Human
│ │ │
│── POST /agent-signup ──▶│ │
│◀── API key (sandboxed) ─│── verification email ──▶│
│ │ │
│ uses key (50 credits) │ │
│ │ │
│ │◀── confirm or block ────│
│ │ │
│ key upgraded to full │ │
│ plan (if confirmed) │ │
curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
-H "Content-Type: application/json" \
-d '{
"email": "user@company.com",
"agent_name": "Research Assistant",
"accept_terms": true
}'
{
"success": true,
"api_key": "fc-...",
"sponsor_status": "pending",
"credit_limit": 50,
"credits_remaining": 50,
"verification_deadline_at": "2026-03-23T12:00:00.000Z",
"tos_url": "https://firecrawl.dev/terms-of-service"
}
api_key retornada imediatamente para scraping, busca e outras operações do Firecrawl. A chave funciona imediatamente, mas fica limitada a 50 credits até a confirmação humana.
Enquanto sponsor_status estiver "pending":
- A chave tem um limite rígido de 50 créditos. Quando esse limite se esgota, as requisições retornam
402 com error: "unverified_credit_limit_reached".
- Todas as requisições de scraping ficam limitadas ao modo somente índice (sem renderização completa no navegador).
- A chave expira se não for confirmada em até 5 dias.
Assim que o humano confirmar, a chave é atualizada para o plano completo, sem limite de créditos nem restrições de modo.
| Status | Erro | Significado |
|---|
402 | unverified_credit_limit_reached | Sandbox de 50 créditos esgotado. Peça ao humano para confirmar. |
403 | sponsor_verification_expired | O prazo de 5 dias expirou sem confirmação. |
403 | This API key has been blocked | O humano bloqueou a chave de API. Pare de usá-la. |
409 | A pending agent signup confirmation has already been sent | Já existe uma chave pendente para este email. |
- Confirmar e vincular a chave — Mescla a chave do agente à sua conta do Firecrawl. Se você não tiver uma conta, uma será criada para você. A chave herda os limites do seu plano.
- Bloquear esta chave — Desativa a chave imediatamente e impede futuros cadastros de agentes com esse email.
Você também pode gerenciar chaves de agentes no painel do Firecrawl. Se você já tiver uma conta, também verá uma notificação no app.
Se você não autorizou o agente, clique em Bloquear esta chave imediatamente. Isso revoga a chave e impede seu uso posterior.
| Endpoint | Descrição |
|---|
POST /v2/agent-signup | Criar uma chave de API em sandbox |
POST /v2/agent-signup/confirm | Confirmar e vincular uma chave a uma conta |
POST /v2/agent-signup/block | Bloquear e desativar uma chave |
