firecrawl/skills

agente firecrawl

Extração autônoma com IA. O agente navega por sites e extrai dados estruturados (leva de 2 a 5 minutos).

Antes de iniciar a extração autônoma para registros ou listagens estruturadas, verifique firecrawl search alexandria '<dados necessários>' para ver se existe um fluxo de trabalho ou provedor de dados pronto. Inspecione um contrato correspondente com firecrawl list <provedor> <capacidade> --pretty e execute com firecrawl scrape --alexandria <provedor>/<capacidade> --options '<JSON de entrada>' se ele cobrir a tarefa. Use o provedor, capacidade e campos de entrada exatos desse contrato. Continue com o Agente quando nenhuma ferramenta adequada existir ou a tarefa exigir navegação autônoma.

Início rápido

# Extrair dados estruturados
firecrawl agent "extraia todos os níveis de preço" --wait --json -o .firecrawl/precos.json

# Com um esquema JSON para saída estruturada
firecrawl agent "extraia produtos" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/produtos.json

# Foco em páginas específicas
firecrawl agent "obtenha lista de funcionalidades" --urls "<url>" --wait --json -o .firecrawl/funcionalidades.json

Execute firecrawl agent --help para a lista completa de opções.

Concluído quando: o arquivo de saída contém JSON válido respondendo à solicitação — ou um ID de trabalho foi intencionalmente retornado para consulta posterior.

Provedores Alexandria

Uma execução usa provedores de dados Alexandria conectados apenas quando inicia com uma flag Alexandria: --alexandria, --toolkits <slugs> (até 5), --max-calls <n>, --require-approval ou --on-terms-required skip|ask. Continuações no mesmo thread mantêm essas configurações.

firecrawl agent "encontre o diretor de vendas da <empresa>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contatos.json

Com --require-approval (necessita --mode chat), uma execução pode terminar com um pendingApproval em vez de fazer uma chamada paga. Pergunte ao usuário e responda no mesmo thread com firecrawl agent "<prompt de continuação>" --thread <threadId> --mode chat --approve <approvalId> (ou --decline <approvalId>). Uma aprovação terms só continua depois que um administrador da organização aceitar os termos do provedor no painel do Firecrawl; forneça ao usuário https://www.firecrawl.dev/app/settings?tab=data-sources e use firecrawl alexandria terms show <provedor> se ele quiser revisar os termos primeiro. Aprovar não os aceita.

IDs de trabalho

Omitir --wait retorna um ID de trabalho. Um argumento posicional UUID é automaticamente detectado como verificação de status:

# Verificar uma vez (equivalente a adicionar --status)
firecrawl agent "<id-do-trabalho>"

# Aguardar um trabalho existente, consultando a cada 10 segundos por até 5 minutos
firecrawl agent "<id-do-trabalho>" --wait --poll-interval 10 --timeout 300

# Cancelar um trabalho ativo
firecrawl agent "<id-do-trabalho>" --cancel

Dicas

• Use --wait para resultados inline; omita apenas quando quiser um ID de trabalho para consultar depois (veja IDs de trabalho).
• Use --schema para saída previsível e estruturada — caso contrário, o agente retorna dados livres.
• Execuções do agente consomem mais créditos do que raspagens simples. Use --max-credits para limitar gastos.
• Para extração simples de uma única página, prefira scrape — é mais rápido e barato.

Veja também

• firecrawl-scrape — extração mais simples de página única
• firecrawl-interact — scrape + interação para interação manual com a página (mais controle)
• firecrawl-crawl — extração em massa sem IA
• firecrawl-build-scrape — construir extração estruturada em um aplicativo em vez de executá-lo aqui

Feedback de sessão Alexandria

Para reportar um resultado de sessão Alexandria ou uma lacuna de provedor/capacidade, use firecrawl alexandria feedback --rating good|partial|bad --url <site> --requested-functionality '<o que era necessário>' --objective '<o objetivo subjacente da tarefa>' --rationale '<o que aconteceu>' --json. Use resultados observados na justificativa. Nenhum ID de trabalho é necessário; envie dentro de 20 minutos da sua última pesquisa, descoberta ou execução no Alexandria, ou será rejeitado. Cada submissão reembolsa 1 crédito, até 10 por site e 100 por equipe por dia UTC. Arrays JSON opcionais --provider-feedback e --capability-feedback descrevem lacunas específicas; inspecione firecrawl alexandria feedback --help para seus campos. Use o problema de capacidade missing_capability quando um provedor existe mas falta a capacidade necessária, e new_capability_request (com requestedFunctionality) para solicitar uma.