Agent Signup permite que los agentes de IA creen claves API de Firecrawl de forma programática — sin navegador, sin OAuth y sin intervención humana en el momento de la creación. El agente proporciona el email de una persona, y Firecrawl aprovisiona una clave API aislada que funciona de inmediato con un límite de 50 créditos. La persona recibe un email para confirmar o bloquear la clave.
No se requiere autenticación. El endpoint /agent-signup es público. Los agentes no necesitan una clave API existente para llamarlo.
- El agente llama a
POST /v2/agent-signup con el email del usuario, el nombre del agente y accept_terms: true.
- Firecrawl devuelve una API key de inmediato. La clave queda aislada con 50 créditos y limitada a scraping solo de índice hasta que el patrocinador la confirme.
- La persona recibe un email con dos enlaces: Confirmar y vincular la clave o Bloquear esta clave.
- Al confirmar, la clave aislada se fusiona con la cuenta existente de la persona en Firecrawl (o se crea una cuenta nueva). La clave hereda los límites completos del plan.
- Al bloquear, la clave se desactiva y el email queda protegido frente a futuros registros no 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 devuelta de inmediato para scraping, búsquedas y otras operaciones de Firecrawl. La clave funciona al instante, pero está limitada a 50 créditos hasta que la persona confirme.
Gestión de los límites del Sandbox
sponsor_status sea "pending":
- La clave tiene un tope estricto de 50 créditos. Una vez consumidos, las solicitudes devuelven
402 con error: "unverified_credit_limit_reached".
- Todas las solicitudes de scrape están limitadas al modo de solo índice (sin renderizado completo en el navegador).
- La clave caduca si no se confirma en un plazo de 5 días.
Una vez que la persona confirma, la clave se actualiza a su plan completo, sin límite de créditos ni restricciones de modo.
| Status | Error | Significado |
|---|
402 | unverified_credit_limit_reached | Se agotó el sandbox de 50 créditos. Pídele a la persona que confirme. |
403 | sponsor_verification_expired | Venció el plazo de 5 días sin confirmación. |
403 | This API key has been blocked | La persona bloqueó la clave API. Deja de usarla. |
409 | A pending agent signup confirmation has already been sent | Ya hay una clave pendiente para este email. |
- Confirmar y vincular clave — Fusiona la clave del agente con tu cuenta de Firecrawl. Si no tienes una cuenta, se crea una para ti. La clave hereda los límites de tu plan.
- Bloquear esta clave — Deshabilita la clave de inmediato y evita futuros registros de agentes desde ese email.
También puedes gestionar las claves de agentes desde el panel de control de Firecrawl. Si ya tienes una cuenta, también verás una notificación en la aplicación.
Si no autorizaste al agente, haz clic en Bloquear esta clave de inmediato. Esto revoca la clave y evita que se siga usando.
| Endpoint | Descripción |
|---|
POST /v2/agent-signup | Crear una clave API aislada |
POST /v2/agent-signup/confirm | Confirmar y vincular una clave API a una cuenta |
POST /v2/agent-signup/block | Bloquear y deshabilitar una clave API |
