- Obter credenciais
- Skills + CLI
- Usando o Firecrawl como ferramenta
- Depuração agêntica
- servidor MCP do Firecrawl
- Documentação do Firecrawl para agentes
- Guias de início rápido
- Integrações com agentes
- SDKs
Obter credenciais
- 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.
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 chave de API 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.Skills + CLI
--allinstala cada segmento de skills do Firecrawl (CLI, build, fluxos de trabalho) em todos os agentes de programação com IA detectados na máquina--browserabre o navegador automaticamente para autenticação no Firecrawl
O que a instalação oferece
firecrawl/cli— skills de CLI para trabalho na web em tempo realfirecrawl/skills— skills de build para integração com aplicaçõesfirecrawl/firecrawl-workflows— skills de fluxo de trabalho para entregáveis repetíveis
Skills de build — para integrar o Firecrawl ao código da aplicação:
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
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. As skills de build 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
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: Tarefas de pesquisa, busca de documentação, análise competitiva, resposta a perguntas que exigem informações atualizadas da web.
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
- 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
/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
rationale 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.servidor MCP do Firecrawl
Authorization: Bearer fc-YOUR-API-KEY para desbloquear todas as ferramentas e limites mais altos.
Ou adicione o servidor local em qualquer cliente MCP:
servidor MCP
Veja as instruções de instalação para Cursor, Claude Desktop, Windsurf, VS Code e outros.
Documentação do Firecrawl para agentes
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 MCP do Firecrawl em qualquer cliente MCP (Cursor, Claude Code, Claude Desktop, Windsurf). Consulte a página servidor MCP para ver os comandos de instalação.
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
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
npx -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.

