Skip to main content
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.

​
Cómo funciona

  1. El agente llama a POST /v2/agent-signup con el email del usuario, el nombre del agente y accept_terms: true.
  2. 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.
  3. La persona recibe un email con dos enlaces: Confirmar y vincular la clave o Bloquear esta clave.
  4. 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.
  5. Al bloquear, la clave se desactiva y el email queda protegido frente a futuros registros no autorizados.

​
Para agentes

​
Crear una clave

Respuesta:
Usa la 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

Mientras 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.

​
Gestión de errores

​
Para personas

Cuando un agente crea una clave con tu email, recibes un email con dos opciones:
  • 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.

​
Referencia de la API