firecrawl setup build). Usuários do Firecrawl podem obter uma chave de API de duas maneiras. Veja Obter credenciais abaixo.
- Obter credenciais
- Skills de CLI e skill de agente
- Usando o Firecrawl como ferramenta
- Depuração agêntica
- Firecrawl MCP
- Documentação do Firecrawl para agentes
- Guias de início rápido
- Integrações com agentes
- SDKs
Obter credenciais
Os usuários do Firecrawl podem obter uma API key de duas formas. A maioria deve fazer login pelo painel ou pela CLI. Se a sua plataforma de agente for compatível com WorkOS ID-JAG, ela poderá se registrar diretamente no Firecrawl. Qual devo usar? Use o painel ou a CLI, a menos que você saiba que sua plataforma é compatível com WorkOS ID-JAG. Como você pode ter chegado aqui:- Docs: você chegou a esta página. Escolha a opção abaixo que corresponde à forma como você pode fazer login.
- API
401: agentes compatíveis com ID-JAG podem seguir o fluxo de descoberta na Etapa 1 deauth.md. Todos os demais devem usar o painel ou a CLI. - URL direta: siga
SKILL.mdpara fazer login pelo navegador e configurar tudo, ouauth.mdpara registro com WorkOS ID-JAG. - Stripe Projects: em um projeto que já usa a CLI do Stripe,
stripe projects add firecrawl/api --name firecrawlprovisiona a conta e gravaFIRECRAWL_API_KEYno.env. Consulte Stripe Projects.
Use o painel ou a CLI
Padrão para a maioria dos usuários. Faça login no navegador, execute a CLI com
--browser, instale skills e MCP ou crie uma API key no painel.Registre-se com WorkOS ID-JAG
Para plataformas de agente compatíveis. Use esta opção quando sua plataforma puder emitir um WorkOS ID-JAG para o Firecrawl. Consulte Agent Auth e depois siga
auth.md.CLI e skills de agente
A CLI do Firecrawl permite que seu agente faça busca, scraping, interaja, faça rastreamento, mapeamento, extração e execute jobs de agente pelo terminal. Ela foi criada para humanos, agentes de IA e pipelines de CI/CD. As skills do Firecrawl são pacotes de conhecimento autocontidos que agentes de codificação de IA, como Codex, Claude Code, Cursor e OpenCode, descobrem e usam automaticamente. Um único comando de instalação configura as ferramentas de CLI para trabalho web em tempo real e as skills de fluxo de trabalho para produzir entregas repetíveis. As skills de build para integrar o Firecrawl ao código da aplicação são instaladas comfirecrawl setup build:
--allpula a seleção de agentes e inicializa todos os agentes detectados--browserabre o navegador automaticamente para autenticação no Firecrawl--skip-auth,--skip-install,--skip-skillse--agent <name>também estão disponíveis. Vejafirecrawl init --help.
O que a instalação oferece
As skills do Firecrawl cobrem três categorias. Oinit instala as skills de CLI e de fluxo de trabalho. Execute firecrawl setup build para as skills de build. Cada segmento fica em seu próprio repositório para poder evoluir de forma independente:
firecrawl/cli— skills de CLI para trabalho web em tempo realfirecrawl/skills— skills de build para integração com aplicaçõesfirecrawl/firecrawl-workflows— skills de fluxo de trabalho para entrega repetível
A instalação acima inclui ambas as skills de índice. Para adicionar apenas a de busca de papers a uma configuração existente — vale a pena quando o trabalho envolve literatura biomédica ou científica — execute:
Skills de fluxo de trabalho — skills focadas em resultados que produzem um entregável concreto a partir de dados da web do Firecrawl:
Escolha seu caminho
As skills de CLI e de fluxo de trabalho vêm da instalação acima. As skills de build são uma etapa separada:firecrawl setup build. A diferença está no que acontece depois:
1
Ferramentas web em tempo real (skills de CLI)
Use esta opção quando precisar de dados da web na sessão atual — para buscar na web, fazer scraping de URLs conhecidas, interagir com páginas extraídas, fazer rastreamento de documentação, mapear um site ou executar um job de agente.O fluxo padrão:
- Comece com busca quando precisar descobrir conteúdo
- Vá para scraping quando já tiver uma URL
- Use interagir quando a página extraída precisar de ações complementares
- Use map ou rastreamento quando precisar de muitas URLs ou páginas
- Use agent quando a tarefa for aberta e exigir descoberta autônoma
2
Integração com aplicação (skills de Build)
Use esta opção quando estiver criando uma aplicação, agente ou fluxo de trabalho que chama a API do Firecrawl via código. Instale as skills de build com
firecrawl setup build. Elas ajudam a escolher o endpoint certo, configurar o SDK e executar um smoke test.O agente responde a uma pergunta central — o que o Firecrawl deve fazer no produto? — e as skills de build encaminham para /search, /scrape, /interact, /parse, /crawl, /map ou /agent, conforme o caso.3
Entregas repetíveis (skills de fluxo de trabalho)
Use esta opção quando o objetivo for um artefato finalizado — um relatório de pesquisa, auditoria de SEO, relatório de QA, lista de leads, base de conhecimento, resumo de inteligência competitiva ou um sistema de design clonado — e não dados brutos da web ou código de produto.As skills de fluxo de trabalho inferem primeiro com base no contexto e só fazem perguntas curtas de esclarecimento quando uma entrada bloquearia o trabalho. Elas também destacam unidades que podem ser paralelizadas de forma independente para que subagentes possam se distribuir entre concorrentes, páginas ou fontes.Escolha um workflow diretamente ou deixe a skill abrangente
firecrawl-workflows encaminhar a solicitação:4
API REST (sem necessidade de instalação)
Se preferir não instalar nada, agentes podem chamar a API REST do Firecrawl diretamente. Defina a chave de API e chame os endpoints:
POST https://api.firecrawl.dev/v2/search— descobre páginas por consultaPOST https://api.firecrawl.dev/v2/scrape— extrai markdown limpo de uma URLPOST https://api.firecrawl.dev/v2/scrape/{scrapeId}/interact— interage com uma página extraídaPOST https://api.firecrawl.dev/v2/crawl— extrai em lote um site inteiroPOST https://api.firecrawl.dev/v2/map— descobre URLs em um domínioPOST https://api.firecrawl.dev/v2/agent— executa coleta autônoma de dados da web
Authorization: Bearer fc-YOUR_API_KEY- Login no navegador, configuração da CLI, skills, MCP e chaves do painel:
firecrawl.dev/agent-onboarding/SKILL.md - Registro de agente com WorkOS ID-JAG:
firecrawl.dev/auth.md
agent-onboarding/SKILL.md para onboarding de CLI/navegador com humano no circuito, ou auth.md para registro no WorkOS ID-JAG.
skills de CLI
Trabalho web em tempo real durante uma sessão de agente — busca, scraping, interact, map, rastreamento e execução de jobs de agente pelo terminal.
skills de build
Integre o Firecrawl ao código da aplicação — escolha o endpoint certo, configure o SDK e entregue uma integração validada.
skills de fluxo de trabalho
Produza entregas repetíveis — resumos de pesquisa, auditorias de SEO, relatórios de QA, listas de leads, bases de conhecimento e clones de design.
Usando o Firecrawl como ferramenta
O Firecrawl oferece aos agentes cinco ferramentas principais para trabalhar com a web. Cada ferramenta corresponde a um endpoint da API e a um comando na CLI. Os agentes escolhem a ferramenta certa com base no que precisam:Search — descubra páginas por consulta
Search — descubra páginas por consulta
Comece por aqui quando você ainda não tiver uma URL. A busca retorna páginas relevantes da web para uma consulta em linguagem natural, com a opção de incluir o conteúdo completo da página nos resultados.Quando usar: Pesquisa geral na web, busca de documentação, análise competitiva, resposta a perguntas que exigem informações atualizadas da web.Quando não usar: Literatura científica. Para encontrar artigos, ler trechos de um deles ou seguir citações, use o Research Index — as ferramentas MCP
firecrawl_research_*, firecrawl research search-papers na CLI ou a habilidade firecrawl-research-index. A busca retorna snippets de páginas da web; o Research Index retorna registros de artigos com resumos completos.Scraping — extraia conteúdo de uma URL
Scraping — extraia conteúdo de uma URL
Use-o quando você já tiver uma URL e precisar de conteúdo limpo, pronto para LLM. O Scraping converte qualquer página da web em markdown, HTML ou dados estruturados — lidando automaticamente com renderização de JavaScript, medidas anti-bot e HTML desorganizado.Quando usar: Leitura de documentação, extração de conteúdo de artigos, coleta de dados de uma página conhecida, conversão de páginas da web em contexto para LLMs.
Rastreamento — extraia em massa um site inteiro
Rastreamento — extraia em massa um site inteiro
O Rastreamento segue links recursivamente a partir de uma URL inicial e faz scraping de todas as páginas que encontra. Use-o quando você precisar de conteúdo de um site inteiro ou de um conjunto de documentação, e não apenas de uma única página.Quando usar: Ingestão de sites completos de documentação, criação de bases de conhecimento, migração de conteúdo, coleta de dados de treinamento.
Map — descubra todas as URLs de um domínio
Map — descubra todas as URLs de um domínio
O Map descobre rapidamente todas as URLs indexadas em um domínio sem fazer scraping do conteúdo. Use-o quando você precisar entender a estrutura de um site ou encontrar páginas específicas antes de extrair o conteúdo delas.Quando usar: Auditorias de site, busca de páginas específicas em um site grande, entendimento da estrutura do site antes de um rastreamento direcionado.
Interagir — trabalhe com uma página extraída
Interagir — trabalhe com uma página extraída
O Interagir permite que os agentes continuem a partir de um scraping usando prompts ou código. Use-o quando uma página extraída exigir cliques, preenchimento de formulários, navegação ou extração complementar.Quando usar: Continuação a partir de um scraping, navegação em páginas dinâmicas, preenchimento de formulários e extração de dados após ações na página.
Como os agentes encadeiam ferramentas
A maioria dos fluxos de trabalho de agentes combina várias ferramentas. Um padrão típico:- Search para encontrar páginas relevantes → obter uma lista de URLs
- Scrape das URLs mais relevantes → obter conteúdo limpo
- Interact quando a página extraída exigir ações de acompanhamento
- Agent quando a tarefa exigir descoberta autônoma ou extração estruturada em várias páginas
depuração agêntica
Quando uma chamada do Firecrawl falha ou retorna resultados inesperados, seu agente não precisa encaminhar o caso para um humano. O endpoint/support/ask é um agente de suporte com IA criado para comunicação entre agentes — ele diagnostica problemas com seus jobs, conta e uso da API e, em seguida, retorna uma resposta verificada com parâmetros de correção legíveis por máquina que seu agente pode aplicar diretamente.
Integre-o ao fluxo de tratamento de erros do seu agente para que ele possa se recuperar sozinho de falhas de scraping, problemas de rastreamento e erros de configuração — normalmente em 15–30 segundos, sem intervenção humana.
Como funciona
- Seu agente descreve o problema — uma pergunta em linguagem natural que descreve o problema.
- O agente de suporte investiga — ele inspeciona os logs do job, o estado da conta, a documentação e o código-fonte.
- O agente de suporte valida — quando possível, ele testa uma correção na API Firecrawl em produção (por exemplo, refazendo um scraping com parâmetros ajustados).
- Seu agente recebe uma resposta verificada — um
answerem texto corrido,fixParameterslegíveis por máquina para aplicar diretamente e resultados devalidationmostrando se a correção foi testada.
Exemplo
Envie uma pergunta, além de umrationale opcional para dar contexto ao agente de suporte sobre o que seu usuário final está tentando fazer:
answer, uma classificação de confidence, fixParameters opcionais (por exemplo, {"waitFor": 5000}) que seu agente pode passar na próxima chamada e validation, indicando se a correção foi testada na API real.
Referência do endpoint Ask
Schema completo de requisição e resposta para
/support/ask, incluindo códigos de status e o envelope de feedback retornado quando o agente não consegue prosseguir.Firecrawl MCP
O MCP é um protocolo aberto que permite que aplicações compatíveis deem aos modelos acesso a ferramentas. O Firecrawl MCP, de código aberto, oferece suporte a busca, scraping, navegação, rastreamento, mapeamento, extração estruturada com Scrape JSON e jobs autônomos de agente.Escolha uma conexão MCP
Experimente o acesso sem API key, faça login com um cliente interativo ou configure uma API key para agentes, CI e serviços de backend.
Documentação do Firecrawl para agentes
Você pode fornecer ao seu agente a documentação atual do Firecrawl de forma contextual. Os agentes podem começar a usar por conta própria ao buscar esses recursos diretamente — sem configuração manual por humanos.1
Obter credenciais
Comece em Obter credenciais para escolher entre a configuração pelo painel/CLI e o registro no WorkOS ID-JAG. Para o registro do ID-JAG, siga
auth.md.2
Docs em markdown
Cada página tem uma versão em markdown. Adicione
.md a qualquer URL da documentação ou use o menu de ações da página para copiar a página em markdown.3
llms.txt completo
Forneça ao seu agente toda a nossa documentação em um único arquivo.Uma versão resumida do índice também está disponível em
https://docs.firecrawl.dev/llms.txt.4
Servidor de docs MCP
Para uma abordagem estruturada com ferramentas MCP, conecte o servidor Firecrawl MCP no Codex, Cursor, Claude Code, Claude Desktop ou outro cliente compatível. Comece com o seletor de configuração do MCP. Usuários do Windsurf devem seguir o guia de início rápido do Windsurf.
5
Copiar para ChatGPT / Claude
Cada página inclui um menu de ações contextual (copiar, visualizar em markdown, abrir no ChatGPT, abrir no Claude), para que agentes e humanos possam mover páginas entre ferramentas com um clique.
Guias de início rápido
Guias de início rápido prontos para uso para as stacks que os agentes mais usam. Aponte seu agente para qualquer um deles para gerar uma integração Firecrawl funcional de ponta a ponta. Prefere deixar o Cursor fazer o trabalho? Instale o servidor MCP do Firecrawl com um clique e comece a enviar prompts no Cursor:
Node.js
JavaScript e TypeScript do lado do servidor com o SDK de Node do Firecrawl.
Next.js
Faça scraping, busca e rastreamento com route handlers e server actions do Next.js.
Python
Use o Firecrawl em scripts, notebooks e serviços de backend.
FastAPI
Crie APIs Python assíncronas para busca, scraping e extração.
Cloudflare Workers
Execute o Firecrawl na edge com Workers.
Vercel Functions
Chame o Firecrawl a partir de funções serverless da Vercel.
AWS Lambda
Invoque o Firecrawl a partir de handlers do Lambda.
Supabase Edge Functions
Use o Firecrawl no runtime Deno do Supabase.
Go
SDK Go idiomático para busca, scraping e rastreamento.
Rust
SDK Rust tipado para Firecrawl.
Laravel
Adicione o Firecrawl a apps Laravel com o SDK PHP.
Rails
Use o Firecrawl no Ruby on Rails.
Integrações com agentes
O Firecrawl funciona com os runtimes e frameworks em que os agentes realmente rodam — agentes de código, SDKs de agentes e agregadores de modelos. A maioria desses ambientes de codificação consegue descobrir automaticamente as skills do Firecrawl vianpx -y firecrawl-cli@latest init --all --browser; os demais usam o Firecrawl como ferramenta via MCP ou API REST.
Claude Code
CLI da Anthropic — configure o Firecrawl MCP no Claude Code.
Cursor
Agente para IDE — instale o Firecrawl MCP no Cursor com um clique.
OpenCode
Conecte o Firecrawl MCP ao OpenCode.
Codex CLI
Conecte o Firecrawl MCP ao OpenAI Codex CLI.
OpenRouter
Combine qualquer modelo do OpenRouter com as ferramentas web do Firecrawl.
Amp
Conecte o Firecrawl MCP ao Sourcegraph Amp.
Windsurf
IDE com agentes — configure o Firecrawl MCP no Windsurf.
Antigravity
Adicione o Firecrawl MCP à IDE com agentes do Google.
Gemini CLI
Conecte o Firecrawl MCP ao Google Gemini CLI.
Nous Research
Use o Firecrawl como ferramenta com modelos Hermes.
AutoGen
Ferramentas do Firecrawl nas equipes multiagente do Microsoft AutoGen.

