DEV Community

Cover image for Como Instalar e Usar Firecrawl CLI: Guia Completo
Lucas
Lucas

Posted on • Originally published at apidog.com

Como Instalar e Usar Firecrawl CLI: Guia Completo

#ai #cli #tutorial #webscraping

Firecrawl CLI é uma ferramenta de terminal que unifica raspagem, busca, mapeamento, rastreamento e automação de navegador em qualquer site. Com ela, agentes de IA e desenvolvedores podem gerar markdown limpo, JSON, capturas de tela e outros formatos diretamente no sistema de arquivos, tudo pronto para ingestão em LLMs ou pipelines automatizados. Rode via npx firecrawl (sem instalação) ou instale globalmente, depois conecte Claude Code, Cursor ou OpenCode com firecrawl init para integração automática de habilidades.

Experimente o Apidog hoje

💡Antes de rodar seus primeiros comandos Firecrawl CLI, obtenha o Apidog gratuitamente. Ele permite testar e depurar visualmente os endpoints da API do Firecrawl usados pelo CLI – chaves, parâmetros, formatos de resposta – direto numa interface visual. Economize tempo ao configurar e depurar integrações de agentes.

Passo 1: Prepare o ambiente e verifique requisitos

  • Node.js >=18 obrigatório. Verifique com: 
  node --version
Enter fullscreen mode Exit fullscreen mode

Atualize via seu gerenciador de pacotes ou nvm se necessário.

  • Crie um diretório de trabalho para organizar as saídas: 
  mkdir firecrawl-cli-projects && cd firecrawl-cli-projects
Enter fullscreen mode Exit fullscreen mode

Isso facilita versionamento e controle dos dados.

  • (Opcional) Desative telemetria: 
  export FIRECRAWL_NO_TELEMETRY=1
Enter fullscreen mode Exit fullscreen mode

Passo 2: Instale e integre o Firecrawl CLI

Instalação rápida e integração com agentes

Execute:

npx -y firecrawl-cli@latest init --all --browser
Enter fullscreen mode Exit fullscreen mode
  • Abre o navegador para login/registro Firecrawl.
  • Gera e armazena a chave de API.
  • Configura habilidades para Claude Code, Cursor, OpenCode, etc.
  • Reinicie seu agente para que ele detecte as novas capacidades.

Instalação global (uso frequente) 

npm install -g firecrawl-cli
firecrawl --version
Enter fullscreen mode Exit fullscreen mode

Permite uso do CLI em qualquer pasta, sem overhead do npx.

Passo 3: Autentique e valide a configuração

  • Login OAuth: 
  firecrawl login
Enter fullscreen mode Exit fullscreen mode
  • Chave manual: 
  export FIRECRAWL_API_KEY=fc-sua-chave-aqui
Enter fullscreen mode Exit fullscreen mode
  • Verifique status e configuração: 
  firecrawl --status
  firecrawl view-config
Enter fullscreen mode Exit fullscreen mode
  • Troque de conta: 
  firecrawl logout
  firecrawl login
Enter fullscreen mode Exit fullscreen mode
  • Firecrawl local/self-hosted: 
  firecrawl --api-url http://localhost:3002
Enter fullscreen mode Exit fullscreen mode

Passo 4: Raspagem de sites com Firecrawl CLI

  • Raspe conteúdo principal de uma URL: 
  firecrawl scrape https://example.com --only-main-content
Enter fullscreen mode Exit fullscreen mode

Adicione -o output.md para salvar o resultado.

  • Vários formatos de saída: 
  firecrawl scrape https://example.com --format markdown,json,html,links,images --pretty
Enter fullscreen mode Exit fullscreen mode
  • Captura de tela: 
  firecrawl scrape https://example.com --screenshot
Enter fullscreen mode Exit fullscreen mode
  • Lidar com carregamento lento: 
  firecrawl scrape https://example.com --wait-for 5000
Enter fullscreen mode Exit fullscreen mode
  • Filtragem por tags: 
  firecrawl scrape https://docs.example.com --include-tags main,article --exclude-tags nav,footer,script
Enter fullscreen mode Exit fullscreen mode
  • Medição de desempenho: 
  firecrawl scrape https://example.com --timing
Enter fullscreen mode Exit fullscreen mode

Passo 5: Busca web automatizada

  • Buscar e raspar resultados: 
  firecrawl search "latest AI agent benchmarks" --scrape --limit 8 --scrape-formats markdown
Enter fullscreen mode Exit fullscreen mode

  • Filtrar por recência/localização/tipo: use flags como --tbs qdr:w.

  • Combine busca com navegação para validação interativa.

Passo 6: Mapeamento e rastreamento de sites

  • Mapeie todas as URLs: 
  firecrawl map https://example.com -o sitemap.json
Enter fullscreen mode Exit fullscreen mode

Use a saída para alimentar comandos de raspagem e rastreamento.

  • Rastreamento recursivo de site inteiro: 
  firecrawl crawl https://example.com --wait --progress -o crawl-output.json
Enter fullscreen mode Exit fullscreen mode

Controle profundidade, número de páginas e concorrência via flags.

Passo 7: Automação de navegador

  • Inicie sessão de navegador em nuvem: 
  firecrawl browser launch-session
Enter fullscreen mode Exit fullscreen mode
  • Ações interativas: 
  firecrawl browser execute "open https://news.ycombinator.com" --session <id>
  firecrawl browser execute "click .titleline > a" --session <id>
  firecrawl browser execute "scrape" --session <id>
Enter fullscreen mode Exit fullscreen mode

Feche a sessão ao terminar para liberar recursos.

Passo 8: Configuração avançada

  • Ajuste comportamentos globais: 
  firecrawl config --api-url https://your-custom-endpoint --concurrency 5
Enter fullscreen mode Exit fullscreen mode
  • Force saída JSON ou ajuste cabeçalhos conforme necessário.
  • Monitore créditos: 
  firecrawl --status
Enter fullscreen mode Exit fullscreen mode
  • Exporte chave no perfil de shell para sessões contínuas.

Passo 9: Integração com agentes de IA

  • Instale uma vez: 
  npx -y firecrawl-cli@latest init --all
Enter fullscreen mode Exit fullscreen mode
  • Agentes descobrem habilidades automaticamente.
  • CLI retorna caminhos de arquivos, não conteúdo bruto, otimizando contexto.

Passo 10: Diagnóstico e resolução de problemas

  • Falha na autenticação: firecrawl login novamente.
  • Limite de taxa: reduza --concurrency ou revise plano.
  • Resultados vazios em sites JS-heavy: aumente --wait-for e ative --only-main-content.
  • Diagnóstico detalhado: --timing.
  • Limpar credenciais: firecrawl logout.

Melhores práticas

  • Sempre utilize --only-main-content para markdown limpo.
  • Use nomes de arquivos e pastas descritivas.
  • Teste escopos pequenos antes de rastreamentos completos.
  • Combine pipelines: busca → mapeamento → rastreamento.
  • Versione saídas para datasets reprodutíveis.
  • Revise uso de créditos semanalmente.

Potencializando o Firecrawl CLI com Apidog

Baixe o Apidog gratuitamente e importe os endpoints Firecrawl (scrape, search, crawl, etc.) para coleções. O Apidog permite visualizar requisições, armazenar a chave de API como variável, simular respostas e executar testes automatizados. Depure opções complexas do Firecrawl CLI antes de executar no terminal. Firecrawl CLI + Apidog = fluxo de dados web + validação de API ponta a ponta.

Conclusão

Com o Firecrawl CLI você domina desde instalação, autenticação, raspagem avançada, busca, mapeamento, rastreamento e automação de navegador. O Firecrawl CLI transforma o acesso web em pipelines limpos no terminal, acelerando agentes e desenvolvedores.

Execute o comando init hoje mesmo, faça sua primeira raspagem e evolua a partir daí. O uso criterioso de flags e experimentação traz ganhos drásticos de produtividade.

Baixe o Apidog agora para potencializar seus testes e validação de API do Firecrawl CLI. Instale, use e desbloqueie o domínio web em tempo real.

Recursos adicionais

Top comments (0)