Pular para o conteúdo principal
Firecrawl /agent é uma API mágica que pesquisa, navega e coleta dados até mesmo dos sites mais complexos, encontrando dados em locais de difícil acesso e descobrindo dados em qualquer lugar da internet. Ele realiza em poucos minutos o que levaria muitas horas para um humano e torna o web scraping tradicional obsoleto. Basta descrever quais dados você quer e o /agent cuida do resto.
Prévia de pesquisa: Agent está em acesso antecipado (early access). Espere algumas imperfeições. Ele ficará significativamente melhor com o tempo. Compartilhe feedback →
Agent aproveita tudo o que há de melhor no /extract e leva isso além:
  • Nenhuma URL necessária: Basta descrever o que você precisa no parâmetro prompt. URLs são opcionais.
  • Pesquisa aprofundada na web: Pesquisa e navega autonomamente em profundidade em sites para encontrar seus dados
  • Confiável e preciso: Funciona com uma grande variedade de consultas e casos de uso
  • Mais rápido: Processa múltiplas fontes em paralelo para resultados mais rápidos
  • Mais barato: Agent é mais econômico do que /extract para casos de uso complexos

Usando /agent

O único parâmetro obrigatório é prompt. Basta descrever quais dados deseja extrair. Para obter uma saída estruturada, forneça um schema JSON. Os SDKs oferecem suporte a Pydantic (Python) e Zod (Node) para definições de schema com segurança de tipos:
from firecrawl import FirecrawlApp
from pydantic import BaseModel, Field
from typing import List, Optional

app = FirecrawlApp(api_key="fc-YOUR_API_KEY")

class Founder(BaseModel):
    name: str = Field(description="Full name of the founder")
    role: Optional[str] = Field(None, description="Role or position")
    background: Optional[str] = Field(None, description="Professional background")

class FoundersSchema(BaseModel):
    founders: List[Founder] = Field(description="List of founders")

result = app.agent(
    prompt="Find the founders of Firecrawl",
    schema=FoundersSchema
)

print(result.data)

Resposta

JSON
{
  "success": true,
  "status": "completed",
  "data": {
    "founders": [
      {
        "name": "Eric Ciarla",
        "role": "Co-founder",
        "background": "Previously at Mendable"
      },
      {
        "name": "Nicolas Camara",
        "role": "Co-founder",
        "background": "Previously at Mendable"
      },
      {
        "name": "Caleb Peffer",
        "role": "Co-founder",
        "background": "Previously at Mendable"
      }
    ]
  },
  "expiresAt": "2024-12-15T00:00:00.000Z",
  "creditsUsed": 15
}

Fornecendo URLs (Opcional)

Opcionalmente, você pode fornecer URLs para que o agente se concentre em páginas específicas:
from firecrawl import FirecrawlApp

app = FirecrawlApp(api_key="fc-YOUR_API_KEY")

result = app.agent(
    urls=["https://docs.firecrawl.dev", "https://firecrawl.dev/pricing"],
    prompt="Compare the features and pricing information from these pages"
)

print(result.data)

Status e conclusão de jobs

Jobs de agente são executados de forma assíncrona. Ao enviar um job, você recebe um Job ID que pode usar para verificar o status:
  • Método padrão: agent() aguarda e retorna os resultados finais
  • Iniciar e depois consultar: use start_agent (Python) ou startAgent (Node) para obter um Job ID imediatamente e depois verificar o status com get_agent_status / getAgentStatus
Os resultados do job ficam disponíveis por 24 horas após a conclusão.
from firecrawl import FirecrawlApp

app = FirecrawlApp(api_key="fc-YOUR_API_KEY")

# Iniciar uma tarefa de agente
agent_job = app.start_agent(
    prompt="Find the founders of Firecrawl"
)

# Verificar o status
status = app.get_agent_status(agent_job.id)

print(status)
# Exemplo de saída:
# status='completed'
# success=True
# data={ ... }
# expires_at=datetime.datetime(...)
# credits_used=15

Estados possíveis

StatusDescrição
processingO agente ainda está trabalhando na sua solicitação
completedExtração concluída com sucesso
failedOcorreu um erro durante a extração

Exemplo pendente

JSON
{
  "success": true,
  "status": "processing",
  "expiresAt": "2024-12-15T00:00:00.000Z"
}

Exemplo concluído

JSON
{
  "success": true,
  "status": "completed",
  "data": {
    "founders": [
      {
        "name": "Eric Ciarla",
        "role": "Co-founder"
      },
      {
        "name": "Nicolas Camara",
        "role": "Co-founder"
      },
      {
        "name": "Caleb Peffer",
        "role": "Co-founder"
      }
    ]
  },
  "expiresAt": "2024-12-15T00:00:00.000Z",
  "creditsUsed": 15
}

Parâmetros

ParâmetroTipoObrigatórioDescrição
promptstringSimDescrição em linguagem natural dos dados que você quer extrair (máx. 10.000 caracteres)
urlsarrayNãoLista opcional de URLs para direcionar a extração
schemaobjectNãoEsquema JSON opcional para saída estruturada

Agent vs Extract: O que melhorou

RecursoAgent (Novo)Extract
URLs obrigatóriasNãoSim
VelocidadeMais rápidaPadrão
CustoMais baixoPadrão
ConfiabilidadeMaiorPadrão
Flexibilidade das consultasAltaModerada

Exemplos de Casos de Uso

  • Pesquisa: “Encontre as 5 principais startups de IA e seus valores de financiamento”
  • Análise de concorrência: “Compare os planos de preços do Slack e do Microsoft Teams”
  • Coleta de dados: “Extraia informações de contato de sites de empresas”
  • Resumo de conteúdo: “Resuma as postagens de blog mais recentes sobre web scraping”

Referência da API

Confira a referência da Agent API para mais detalhes. Tem alguma sugestão ou precisa de ajuda? Envie um e-mail para [email protected].

Preços

O Firecrawl Agent usa cobrança dinâmica, que acompanha a complexidade da sua solicitação de extração de dados. Você paga com base no trabalho efetivamente realizado pelo Agent, garantindo preços justos tanto ao extrair dados simples quanto informações estruturadas complexas de múltiplas fontes.

Como funciona o preço do Agent

Os preços do Agent são dinâmicos e baseados em créditos durante o Research Preview:
  • Extrações simples (como informações de contato de uma única página) normalmente consomem menos créditos e custam menos
  • Tarefas de pesquisa complexas (como análise de concorrência em vários domínios) consomem mais créditos, mas refletem o esforço total envolvido
  • Uso transparente mostra exatamente quantos créditos cada requisição consumiu
  • Conversão de créditos converte automaticamente o uso de créditos do Agent em créditos para facilitar a cobrança
O uso de créditos varia de acordo com a complexidade do seu prompt, a quantidade de dados processados e a estrutura do resultado solicitado.

Começando

Todos os usuários recebem 5 execuções gratuitas por dia para explorar os recursos do Agent sem nenhum custo. O uso adicional é cobrado com base no consumo de créditos e convertido em créditos.

Gerenciando custos

Assuma o controle dos gastos do seu Agent:
  • Comece com execuções gratuitas: Use suas 5 solicitações gratuitas diárias para entender os preços
  • Defina o parâmetro maxCredits: Limite seus gastos definindo um número máximo de créditos que você está disposto a usar
  • Otimize os prompts: Prompts mais específicos geralmente usam menos créditos
  • Monitore o uso: Acompanhe seu consumo pelo painel
  • Ajuste expectativas: Pesquisas complexas em múltiplos domínios vão consumir mais créditos do que extrações simples de uma única página
Teste o Agent agora em firecrawl.dev/app/agent para ver como o uso de créditos escala com seus casos de uso específicos.
Os preços estão sujeitos a alteração à medida que avançamos de Research Preview para disponibilidade geral. Usuários atuais receberão aviso antecipado sobre quaisquer atualizações de preços.