Skill
Firecrawl
Crédito: firecrawl no GitHub (firecrawl/cli) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026
644 estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
---
name: firecrawl-agent
description: Navega de forma autônoma por sites e extrai dados estruturados entre páginas. Use quando a tarefa exigir navegação ou quando nenhum fluxo de trabalho ou provedor de dados pronto a atender.
allowed-tools:
- Bash(firecrawl *)
- Bash(npx firecrawl-cli *)
---
# firecrawl agent
Extração autônoma com IA. O agente navega pelos sites e extrai dados estruturados (leva de 2 a 5 minutos).
Antes de iniciar uma extração autônoma de registros estruturados ou listagens, consulte `firecrawl search alexandria '<data you need>'` para ver se há um fluxo de trabalho ou provedor de dados pronto. Inspecione um contrato correspondente com `firecrawl list <provider> <capability> --pretty` e execute com `firecrawl scrape --alexandria <provider>/<capability> --options '<input JSON>'` se ele cobrir a tarefa. Use exatamente o provedor, a capacidade e os campos de entrada desse contrato. Continue com o Agent quando não existir nenhuma ferramenta adequada ou quando a tarefa exigir navegação autônoma.
## Início rápido
```bash
# Extract structured data
firecrawl agent "extract all pricing tiers" --wait --json -o .firecrawl/pricing.json
# With a JSON schema for structured output
firecrawl agent "extract products" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json
# Focus on specific pages
firecrawl agent "get feature list" --urls "<url>" --wait --json -o .firecrawl/features.json
```
Rode `firecrawl agent --help` para ver a lista completa de opções.
**Concluído quando:** o arquivo de saída contém um JSON válido que responde ao pedido — ou um ID de job foi intencionalmente retornado para consulta posterior.
## IDs de job
Omitir `--wait` retorna um ID de job. Um argumento posicional UUID é detectado automaticamente como uma consulta de status:
```bash
# Check once (equivalent to adding --status)
firecrawl agent "<job-id>"
# Wait on an existing job, polling every 10 seconds for up to 5 minutes
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300
# Cancel an active job
firecrawl agent "<job-id>" --cancel
```
## Dicas
- Use `--wait` para obter os resultados na hora; omita-o apenas quando quiser um ID de job para consultar depois (veja [IDs de job](#job-ids)).
- Use `--schema` para uma saída estruturada e previsível — caso contrário, o agente retorna dados em formato livre.
- As execuções do agente consomem mais créditos do que raspagens simples. Use `--max-credits` para limitar o gasto.
- Para extração simples de uma única página, prefira `scrape` — é mais rápido e mais barato.
## Veja também
- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — extração mais simples de uma única página
- [firecrawl-interact](../firecrawl-interact/SKILL.md) — raspagem + interação para interagir manualmente com a página (mais controle)
- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — extração em massa sem IA
- [firecrawl-build-scrape](https://github.com/firecrawl/skills/tree/main/skills/build/firecrawl-build-scrape) — incorporar a extração estruturada a um aplicativo em vez de executá-la aqui
## Feedback de sessão do Alexandria
Para relatar o resultado de uma sessão do Alexandria ou uma lacuna de provedor/capacidade, use `firecrawl alexandria feedback --rating good|partial|bad --url <website> --requested-functionality '<what was needed>' --objective '<the underlying goal of the task>' --rationale '<what happened>' --json`. Use resultados observados na justificativa (rationale). Nenhum ID de job é necessário; esse feedback de sessão não tem prazo por idade do job nem reembolso de créditos. Os arrays JSON opcionais `--provider-feedback` e `--capability-feedback` descrevem lacunas específicas; inspecione `firecrawl alexandria feedback --help` para ver os campos deles. Use o problema de capacidade `missing_capability` quando um provedor existir, mas não tiver a capacidade necessária, e `new_capability_request` (com `requestedFunctionality`) para solicitar uma.Funciona com:Claude

