Pular para o conteúdo principal
Pesquise, faça scraping, interaja, rastreie, mapeie e execute jobs de agente diretamente do terminal. A CLI do Firecrawl funciona de forma independente ou com skills que agentes de IA para programação, como Claude Code, Antigravity e OpenCode, podem descobrir e usar automaticamente.

Instalação

Se você estiver usando um agente de IA, como o Claude Code, poderá instalar as Firecrawl skills abaixo, e o agente as configurará para você.
  • --all instala todos os segmentos de skills do Firecrawl (CLI, build, fluxos de trabalho) em todos os agentes de codificação de IA detectados
  • --browser abre o navegador automaticamente para autenticação do Firecrawl
Após instalar as skills, reinicie seu agente para que ele as descubra.
Você também pode instalar manualmente a CLI do Firecrawl globalmente usando npm:
CLI

Autenticação

Antes de usar a CLI, você precisa se autenticar com sua chave de API do Firecrawl.
Alguns comandos da CLI funcionam sem login. Sem uma chave de API configurada, os comandos compatíveis recorrem ao plano gratuito sem chave — grátis, mas com limite de taxa por IP. Consulte Limites de taxa para ver a lista atual de comandos sem chave e as ressalvas. Cadastre-se para obter uma chave gratuita e ganhar 1.000 créditos e limites mais altos; a CLI a usa automaticamente assim que ela é configurada.

Login

CLI

Visualizar configuração

CLI

Logout

CLI

Auto-hospedado / Desenvolvimento local

Para instâncias auto-hospedadas do Firecrawl ou para desenvolvimento local, use a opção --api-url:
CLI
Ao usar uma URL de API personalizada (qualquer endereço diferente de https://api.firecrawl.dev), a autenticação por chave de API é automaticamente ignorada, permitindo que você use instâncias locais sem uma chave de API.

Verificar status

Verifique se a instalação e a autenticação estão corretas e consulte os limites de taxa:
CLI
Resultado quando estiver pronto:
  • Concorrência: Máximo de tarefas em paralelo. Execute operações paralelas próximas a esse limite, mas sem ultrapassá-lo.
  • Créditos: Créditos de API disponíveis. Cada operação de scrape/crawl consome créditos.

Comandos

O comando oculto firecrawl browser foi descontinuado para fluxos de trabalho com agentes. Use primeiro firecrawl scrape <url> e depois firecrawl interact ... com a sessão de scraping resultante.

Scraping

Faça scraping de uma única URL e extraia seu conteúdo em vários formatos.
Use --only-main-content para obter um resultado limpo, sem navegação, rodapés ou anúncios. Isso é recomendado para a maioria dos casos de uso em que você quer apenas o artigo ou o conteúdo principal da página.
CLI

Formatos de saída

CLI

Opções de scraping

CLI
Opções disponíveis:
Pesquise na web e, opcionalmente, faça o scraping dos resultados.
CLI

Opções de busca

CLI
Opções disponíveis:

Mapear

Descubra rapidamente todas as URLs de um site.
CLI

Opções para mapear

CLI
Opções disponíveis:

Interact

Faça scraping de uma página e, em seguida, interaja com ela usando linguagem natural ou código. O Interact usa o scraping mais recente por padrão, ou você pode informar um ID de scraping específico.
CLI
Opções disponíveis:

Crawl

Rastreia um site inteiro a partir de uma URL.
CLI

Verificar status do crawl

CLI

Opções de Crawl

CLI
Opções disponíveis:

Monitor

Crie operações recorrentes de scraping ou rastreamento que comparem cada execução ao snapshot anterior. Adicione um objetivo quando quiser que o Firecrawl avalie quais páginas alteradas são relevantes para o seu caso de uso.
CLI
Os objetivos do monitor devem ser curtos e fiéis à intenção do usuário: diga o que deve acionar um alerta, retome qualquer escopo informado e inclua exclusões apenas quando forem óbvias ou explicitamente solicitadas. Se o usuário pedir “any change”, mantenha o objetivo amplo. Opções disponíveis:

Agent

Busque e colete dados na web usando prompts em linguagem natural.
CLI

Opções do Agente

CLI
Opções disponíveis:

Uso de créditos

Verifique o saldo de créditos e o uso pela sua equipe.
CLI

Versão

Exibe a versão da CLI.
CLI

Opções globais

Essas opções estão disponíveis para todos os comandos:

Manipulação da saída

A CLI envia a saída para stdout por padrão, facilitando o uso de pipes ou redirecionamentos:
CLI

Comportamento dos formatos

  • Formato único: Retorna o conteúdo bruto (texto markdown, HTML, etc.)
  • Múltiplos formatos: Retorna um JSON com todos os dados solicitados
CLI

Exemplos

Raspagem rápida

CLI

Rastreamento completo do site

CLI

Descoberta de sites

CLI

Fluxo de Pesquisa

CLI

Agente

CLI

Combine com outras ferramentas

CLI

Telemetria

A CLI coleta dados de uso anônimos durante a autenticação para ajudar a melhorar o produto:
  • Versão da CLI, sistema operacional e versão do Node.js
  • Detecção de ferramenta de desenvolvimento (como Cursor, VS Code, Claude Code)
Nenhum dado relacionado a comandos, URLs ou conteúdo de arquivos é coletado via CLI. Para desativar a telemetria, defina a seguinte variável de ambiente:
CLI

Open Source

A CLI do Firecrawl e os três segmentos de skills são de código aberto no GitHub:
  • firecrawl/cli — a CLI e as skills de CLI (trabalho na web em tempo real)
  • firecrawl/skills — build skills (integre o Firecrawl ao código da aplicação)
  • firecrawl/firecrawl-workflows — skills de fluxo de trabalho (entregáveis repetíveis, como briefs de pesquisa, auditorias de SEO, listas de leads e clones de design)
Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver instruções de integração automatizada.