DEV Community

Cover image for Firecrawl auto-hospedado vs Firecrawl local: o que mudou
Lucas
Lucas

Posted on Originally published at apidog.com

Firecrawl auto-hospedado vs Firecrawl local: o que mudou

Firecrawl Local vs Firecrawl auto-hospedado: um binário ou a stack completa?

O Firecrawl auto-hospedado costumava significar uma coisa: clonar o repositório, rodar o Docker Compose e manter uma API, um serviço Playwright, Redis, RabbitMQ e Postgres ativos na sua máquina. Em 18 de novembro de 2026, o Firecrawl lançou uma segunda opção. O Firecrawl Local é um único binário em Rust que faz scraping, crawling e map de sites para markdown e responde à mesma API v2 em localhost:3002, sem banco de dados, fila ou contêiner.

Experimente o Apidog hoje

Resposta rápida: escolha o Firecrawl Local se quiser scrape, crawl, map e batch scrape em um notebook ou no arsenal de ferramentas de um agente, com zero infraestrutura. Mantenha a stack Docker auto-hospedada se precisar de jobs persistentes, dos formatos json e summary, de extração via LLM com o seu próprio modelo, ou de uma rota de busca que nunca toque o Firecrawl Cloud.

O que é o Firecrawl auto-hospedado e o que é o Firecrawl Local?

O Firecrawl auto-hospedado é o servidor Firecrawl completo do apps/api, executado na sua própria infraestrutura com Docker Compose. O Firecrawl Local é uma build separada e mais leve em apps/local: um único binário que busca e limpa páginas na sua máquina usando o mesmo código de limpeza de HTML, e delega busca, páginas bloqueadas e Alexandria ao Firecrawl Cloud.

Ambos residem no repositório do Firecrawl no GitHub, ambos servem a API v2 na porta 3002 e ambos são de código aberto sob AGPL-3.0. O Firecrawl Local não substitui o servidor. O README do Firecrawl Local diz isso diretamente: o guia de auto-hospedagem "vive em apps/api e não é alterado pelo Firecrawl Local".

Novo no Firecrawl? Comece pelo nosso guia de web scraping do Firecrawl.

Firecrawl Local vs Firecrawl auto-hospedado em resumo

Aqui está a versão curta, montada a partir do guia de auto-hospedagem, da página de código aberto vs cloud e do README do Local, todos lidos em 19 de novembro de 2026.

Firecrawl auto-hospedado Firecrawl Local
O que você executa Stack Docker Compose: api, playwright-service, redis, rabbitmq, nuq-postgres Um binário, firecrawl-local
Instalação git clone, escrever .env, docker compose up --build -d cargo install firecrawl-local
Pré-requisitos Git, Docker Engine, Compose v2 Rust e um compilador C; Chrome e Node 22+ opcionais
API v2 na porta 3002 v2 na porta 3002 (scrape, map, crawl, batch scrape, health)
Rota de busca Incluída na stack padrão Encaminhada ao Firecrawl Cloud
Formatos de LLM (json, summary) Conecte um provedor compatível com OpenAI ou Ollama Ignorados com um aviso
Capturas de tela Exigem Fire-engine, que não está na stack padrão Funcionam se o Chrome estiver instalado
actions de navegador Exigem Fire-engine Ignoradas
Armazenamento de jobs Fila apoiada em Postgres Em memória, expira após 1 hora
Alexandria Não listada na tabela de recursos da auto-hospedagem Via Firecrawl Cloud com uma conta gratuita
Configuração de MCP Aponte o servidor MCP para a sua URL firecrawl-local init grava a configuração
Licença AGPL-3.0 AGPL-3.0

O Local troca profundidade por leveza: mantém as rotas que os agentes mais chamam e abandona o que exige fila, modelo ou um parque de navegadores.

O que mudou: de cinco serviços a um único binário

O caminho auto-hospedado fixa a release v2.11.162 em seu guia. Você clona o repositório, escreve um pequeno .env com as credenciais do Postgres e USE_DB_AUTHENTICATION=false, e então compila e inicia a stack:

git clone https://github.com/firecrawl/firecrawl.git
cd firecrawl
git checkout v2.11.162
docker compose up --build -d
docker compose ps --all
Enter fullscreen mode Exit fullscreen mode

Esse arquivo compose inicia um contêiner api (que também executa os workers), um playwright-service para renderização, redis, rabbitmq e nuq-postgres para a fila de jobs. O arquivo compose limita a API a 4 CPUs e 8 GB de memória, e o serviço Playwright a 2 CPUs e 4 GB, e o guia observa que esses limites "não são requisitos mínimos verificados".

Arquitetura lado a lado: o Firecrawl auto-hospedado executa api com workers, playwright-service, redis, rabbitmq e nuq-postgres sob docker compose up, enquanto o Firecrawl Local é um único binário Rust com Chrome opcional e uma transferência pontilhada para o Firecrawl Cloud para busca, páginas bloqueadas e Alexandria; ambos expõem a API v2 em localhost:3002

O Firecrawl Local reduz tudo isso a um único comando:

cargo install firecrawl-local
firecrawl-local scrape https://example.com --markdown
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
firecrawl-local map https://firecrawl.dev
firecrawl-local serve
Enter fullscreen mode Exit fullscreen mode

Não há .env nem contêineres. Páginas JavaScript são renderizadas no Chrome ou Chromium que você já tem; sem um deles, as páginas estáticas ainda funcionam e o restante retorna um aviso.

Os comandos search, find-tools, data e login acessam o Firecrawl Cloud. O firecrawl-local login reutiliza as credenciais da CLI hospedada do nosso guia de instalação da Firecrawl CLI.

Cobertura de endpoints: o que cada um serve

É aqui que as migrações quebram, então verifique antes de trocar a URL base de um SDK.

O Firecrawl Local serve estas rotas na sua máquina:

  • POST /v2/scrape faz scrape de uma URL
  • POST /v2/map lista as URLs de um site
  • POST /v2/crawl, além de GET e DELETE /v2/crawl/{id}
  • POST /v2/batch/scrape, além de GET e DELETE /v2/batch/scrape/{id}
  • GET /health

Todas as outras rotas /v2, como /v2/search, são encaminhadas ao Firecrawl Cloud, a menos que FIRECRAWL_CLOUD diga o contrário. As rotas v0 e v1 não são servidas de forma alguma.

O Firecrawl auto-hospedado cobre scrape, crawl, map e busca essenciais na sua stack padrão, segundo a página de código aberto vs cloud. A extração com LLM exige um provedor que você conecta. Agent, Browser, Interact e o dashboard não estão incluídos.

Dois problemas práticos:

  1. Os health checks são diferentes. O guia de auto-hospedagem verifica a prontidão em /v0/health/readiness. O Firecrawl Local não serve v0, então use GET /health. Atualize seus monitores e os healthchecks do compose.
  2. A busca muda de onde é executada. Na stack Docker, a busca permanece na sua infraestrutura. No Local, ela vai para o Firecrawl Cloud, e a busca sem chave tem limite de requisições. Defina FIRECRAWL_CLOUD=off se nada puder sair da máquina; a busca então para de funcionar.

Velocidade e memória: leia as alegações com atenção

O post de lançamento no X do Firecrawl diz que o Firecrawl Local é uma "primitiva de scrape em Rust 37x mais rápida (vs auto-hospedado)" e usa "230x menos memória (11 MB ocioso)". O post teve cerca de 324 mil visualizações e 3,2 mil curtidas no primeiro dia.

Trate esses números como alegações do Firecrawl. O README não publica método de benchmark, conjunto de páginas nem hardware, então não podemos dizer o que o "37x" mediu. O que a arquitetura sustenta é a direção: um processo ocioso deve pesar muito menos do que cinco contêineres cujos limites do compose permitem até 12 GB somente entre os serviços API e Playwright.

Se a velocidade decidir sua escolha, meça nas suas próprias URLs. Execute o mesmo scrape nos dois servidores, compare os tempos e verifique se o markdown coincide. A seção sobre a Apidog CLI abaixo mostra uma forma de transformar isso em um teste repetível.

Segurança, transferência para a nuvem e fluxo de dados

A auto-hospedagem lhe dá controle total e responsabilidade total. O quickstart do guia desativa a autenticação e avisa que ela "não é uma arquitetura de produção", então volumes duráveis, autenticação, TLS e monitoramento ficam por sua conta.

O Firecrawl Local vem com padrões mais restritivos para uma única máquina:

  • serve se vincula a 127.0.0.1 e recusa localhost e endereços privados, a menos que você passe --allow-private.
  • Endereços link-local e de metadados da nuvem são bloqueados em todos os modos, inclusive após redirecionamentos.
  • scrape, crawl e mcp aceitam --public-only, que o README recomenda quando um agente navega em sites nos quais você não confia.
  • Crawls respeitam o robots.txt.

O trade-off é a transferência para a nuvem. Com o padrão FIRECRAWL_CLOUD=auto, busca, páginas que bloqueiam sua máquina e Alexandria vão para o Firecrawl Cloud. Esses resultados carregam "source": "firecrawl-cloud". Defina FIRECRAWL_CLOUD=search para permitir apenas busca, ou off para não enviar nada.

Alexandria, o catálogo de provedores de dados do Firecrawl, exige uma conta gratuita e firecrawl-local login. Nosso explicador sobre o Firecrawl Alexandria cobre o que ele retorna.

Qual escolher?

Escolha o Firecrawl Local se:

  • Você quer que um agente de IA faça scrape e crawl no seu notebook. O firecrawl-local init adiciona o servidor MCP ao Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI e Codex, fazendo backup de cada configuração antes.
  • Você executa jobs curtos que terminam em até uma hora.
  • Você só precisa de markdown, HTML, HTML bruto e links.
  • Você não quer administrar Postgres, Redis e RabbitMQ.

Mantenha o Firecrawl auto-hospedado se:

  • Jobs de crawl precisam sobreviver a um reinício ou durar mais de uma hora.
  • Você precisa de saída json ou summary através do seu próprio modelo.
  • A busca precisa permanecer na sua infraestrutura.
  • Vários serviços ou usuários compartilham um único backend de scraping atrás da sua autenticação.

Muitas equipes vão usar os dois: o Local em notebooks e agentes, a stack Docker ou o Firecrawl Cloud em produção. Para configurações de agentes que só precisam de busca, nossa compilação de busca na web open-source para o Claude lista outras opções, e o guia do Firecrawl MCP e llms.txt cobre o servidor MCP hospedado.

Migrando o código do SDK do auto-hospedado para o Local

O código do seu SDK não muda, apenas a URL: defina a URL da API do SDK Python ou Node para http://localhost:3002, sem chave de API para rotas locais. Antes de trocar, confirme que seu código não faz chamadas v0 ou v1, nunca pede json, summary ou actions, e nunca consulta um ID de crawl com mais de uma hora ou entre reinícios do serve.

Deixe seu agente de código executar um teste de paridade com a Apidog CLI

Trocar de backend é uma questão de contrato: o /v2/scrape no Local retorna a mesma estrutura que seu código já trata? Não compare as respostas manualmente. Execute os dois servidores lado a lado (Docker na 3002, firecrawl-local serve --port 3012) e deixe seu agente de código testar ambos com a Apidog CLI.

Configure uma vez:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

Então dê ao seu agente um único prompt:

Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on
http://localhost:3012. In Apidog project <id>, create two environments,
"self-hosted" and "local". Add test cases for POST /v2/scrape on
https://example.com (assert 200, success: true, non-empty data.markdown) and
POST /v2/map (assert 200 and a non-empty links array). Run the cases against
both environments and tell me every assertion that differs.
Enter fullscreen mode Exit fullscreen mode

Teste de paridade: um agente de código executa o mesmo caso de teste da Apidog contra a stack auto-hospedada na porta 3002 e o Firecrawl Local na porta 3012, e então compara os dois relatórios em status, success e markdown

O agente lê o schema do payload, valida e executa o mesmo caso duas vezes:

firecrawl-local serve --port 3012 &
apidog environment create self-hosted --project <id> --base-url http://localhost:3002
apidog environment create local --project <id> --base-url http://localhost:3012
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file scrape-case.json
apidog test-case create --project <id> --file scrape-case.json
apidog run --test-case <caseId> --project <id> -e <selfHostedEnvId> -r cli,json --out-file self-hosted
apidog run --test-case <caseId> --project <id> -e <localEnvId> -r cli,json --out-file local
Enter fullscreen mode Exit fullscreen mode

A Apidog CLI envia requisições da sua máquina, então ambas as portas localhost são acessíveis. Troque -r cli,json por -r junit e a mesma verificação roda no CI a cada atualização do Firecrawl; nosso guia de CI/CD da Apidog CLI mostra a configuração, e Apidog CLI no Claude Code cobre o lado do agente. O plano Free da Apidog atende equipes de até 4 usuários.

Perguntas frequentes

O Firecrawl Local substitui o Firecrawl auto-hospedado? Não. É uma build separada em apps/local. O servidor completo em apps/api e seu guia de auto-hospedagem permanecem inalterados, e você ainda precisa dele para jobs persistentes e formatos de LLM.

O Firecrawl Local é realmente 37x mais rápido que o Firecrawl auto-hospedado? Essa é a alegação do Firecrawl em seu post de lançamento, junto com 230x menos memória e 11 MB ocioso. O README não publica método de benchmark, então teste com suas próprias URLs.

O Firecrawl Local funciona sem a nuvem? Sim. Defina FIRECRAWL_CLOUD=off e scraping, crawling e mapping permanecem na sua máquina. A busca, o fallback de páginas bloqueadas e Alexandria param de funcionar.

O Firecrawl auto-hospedado é gratuito? O código é gratuito sob AGPL-3.0, tanto para o servidor quanto para o Local. Você paga pelas máquinas e pelo tempo de administrar Postgres, Redis e RabbitMQ por conta própria.

Qual deles um agente de IA deve usar? O Firecrawl Local, na maioria dos casos. O firecrawl-local init o registra como servidor MCP em seis ferramentas de agente, e --public-only impede que um agente alcance sua rede privada.

Top comments (0)