Firecrawl CLI: acrescentar extração e pesquisa aos agentes no terminal

Para quem

Este guia é para quem precisa, num terminal local, de pesquisa web, extração de páginas, interação, rastreio de sites, sitemaps ou executar tarefas de agente. Oficialmente é ao mesmo tempo uma entrada de linha de comandos e uma competência de agente que se pode instalar nos editores de código detetados.

Se o seu trabalho é ler primeiro páginas públicas e só depois decidir se altera o código — em vez de construir um serviço de extração — este caminho encaixa melhor. As notas oficiais também mencionam pesquisar artigos e material para programadores. Não serve para quem só quer uns cliques numa interface gráfica e não consegue executar comandos de terminal: o caminho recomendado instala uma ferramenta CLI, conclui o início de sessão e escreve competências nos editores detetados.

O repositório oficial é

https://github.com/firecrawl/cli

Siga apenas a formulação atual dessa página. Não mude para um instalador ou diretório de competências que não apareça aí.

Primeira tentativa em 3 minutos

Siga apenas o caminho oficial recomendado.

Pré-requisitos: o terminal consegue executar npx e já tem um método de acesso ao Firecrawl. As notas oficiais também permitem definir a variável de ambiente FIRECRAWL_API_KEY; init com --browser usa o início de sessão no navegador. Antes de executar, confirme que vai iniciar sessão na sua própria conta e veja que, por omissão, a escrita vai para todos os editores de código detetados, não para um diretório temporário.

Local de instalação: as competências instalam-se por omissão de forma global nos editores detetados. Para visar apenas um, a forma oficial acrescenta --agent <agent>.

Copie e execute:

npx -y firecrawl-cli@latest init -y --browser

Sinal de sucesso: o comando termina normalmente, esta máquina consegue invocar firecrawl e os editores detetados mostram uma competência nova. Ainda não rastreie um site inteiro. A seguir, faça uma verificação reversível: execute firecrawl setup core. As notas oficiais dizem que este grupo fornece as primitivas scrape, search, crawl e interact, mais competências de índice; skills é o alias. Depois de o comando ser aceite, peça ao agente instalado um pedido só de leitura, por exemplo «Usa o Firecrawl para pesquisar o título de um documento público, mostra só os resultados e não escrevas ficheiros». Ver os resultados significa que a competência foi encontrada.

Quando precisar de competências de integração de aplicações que falem com a API Firecrawl, execute então firecrawl setup build. Quando precisar de receitas de ponta a ponta como geração de pistas ou investigação profunda, execute então firecrawl setup workflows. Na primeira vez, instale só core para não escrever todas as receitas de uma vez.

Exemplos de uso

Exemplo 1: acrescentar primitivas de pesquisa e extração ao agente atual. A ação oficial é firecrawl setup core, que instala as primitivas scrape, search, crawl e interact mais as competências de índice. Encaixa se já trabalha num editor detetado e quer que o agente pesquise ou extraia páginas públicas antes de decidir alterar o repositório. Conclua primeiro o init acima e depois instale só core. Em caso de sucesso, uma conversa deve disparar uma pesquisa ou extração e mostrar um resumo dos resultados. O material oficial não dá um caminho de pasta de competências; não invente um diretório que nunca aparece.

Exemplo 2: precisa de receitas prontas em vez de primitivas isoladas. A ação oficial é firecrawl setup workflows; o material cita geração de pistas e investigação profunda. Encaixa quando o core já funciona e agora quer investigar por receitas. Confirme o sucesso do init e depois execute esse comando; para instalar só num editor, acrescente --agent <agent>. O sinal de sucesso é esse grupo de competências aparecer no editor de destino. Os passos internos das receitas não estão desenvolvidos; o material existente só confirma que o workflows está instalado e não se podem completar subpassos não escritos.

Limites

O material existente pára nos comandos de terminal, no início de sessão no navegador ou em FIRECRAWL_API_KEY, e nos três grupos de instalação core, build e workflows. Não exige uma língua obrigatória nem transforma «editores detetados» numa lista exclusiva; não infira do âmbito de instalação por omissão que só uns poucos clientes funcionam.

Não aplique este init npx a um ambiente que só permite copiar à mão ficheiros de competências e não tem uma linha de comandos geral. O material também não dá um endereço de mercado secundário nem um segredo de exemplo.

init e setup escrevem competências nos editores detetados e têm efeitos secundários. Confirme primeiro o editor de destino; depois de executar, verifique só se as competências apareceram — não rastreie de imediato um site não autorizado. Extração, interação e rastreio chegam a sites externos; verifique primeiro com uma página pública que possa voltar a abrir.

FIRECRAWL_API_KEY é um nome de variável de ambiente, não um segredo de exemplo para colar no texto. Não invente subcomandos, nomes de competências ou caminhos de instalação que nunca aparecem. Para mais pormenor, siga o repositório oficial:

https://github.com/firecrawl/cli