Firecrawl auto-hospedado vs Firecrawl local: o que mudou

O Firecrawl auto-hospedado executa cinco serviços no Docker Compose. O Firecrawl Local é um único binário Rust que disponibiliza a mesma API v2 em localhost:3002. Veja o que cada opção abrange, o que significa a afirmação de 37x e qual escolher.

INEZA Felin-Michel

INEZA Felin-Michel

19 novembro 2026

Firecrawl auto-hospedado vs Firecrawl local: o que mudou

Apidog para empresas

Implantação local

SSO & RBAC

Conforme SOC 2

Explorar Apidog Enterprise

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.

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

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

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:

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:

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:

Mantenha o Firecrawl auto-hospedado se:

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

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.
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

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.

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs