O que é Firecrawl Local? Execute o Firecrawl na sua própria máquina

Firecrawl Local é um único binário em Rust que faz scraping, crawling e mapeamento de sites para markdown na sua própria máquina e disponibiliza a API v2 do Firecrawl em localhost:3002. Veja o que roda localmente, o que vai para a nuvem, como instalá-lo e quais são suas limitações.

INEZA Felin-Michel

INEZA Felin-Michel

19 novembro 2026

O que é Firecrawl Local? Execute o Firecrawl na sua própria máquina

Apidog para empresas

Implantação local

SSO & RBAC

Conforme SOC 2

Explorar Apidog Enterprise

O Firecrawl Local é um único binário em Rust que faz scraping, crawling e mapeamento de sites para markdown limpo na sua própria máquina. Você o instala com cargo install firecrawl-local, e ele pode servir a API v2 do Firecrawl em localhost:3002 sem chave de API, sem banco de dados, sem fila e sem contêiner. A busca e alguns outros recursos ainda vão para o Firecrawl Cloud, e você pode desativar isso.

A seguir: o que roda no seu laptop, o que vai para a nuvem, como instalá-lo, as rotas de API que ele serve, seus limites, e como permitir que seu agente de código teste a API local com o Apidog CLI.

O que é o Firecrawl Local?

O Firecrawl Local é a edição open-source e local do Firecrawl. É um único binário que busca páginas da web, limpa-as com o mesmo código de limpeza de HTML que a API hospedada do Firecrawl usa, e retorna markdown, HTML ou links. Ele roda como CLI, como servidor MCP para agentes de IA, ou como uma cópia local da API v2 do Firecrawl.

O Firecrawl o anunciou em 18 de novembro de 2026 em uma postagem de lançamento no X, e o código fica na pasta apps/local do repositório do Firecrawl. O pacote está publicado no crates.io como firecrawl-local, e o repositório tem licença AGPL-3.0.

O Firecrawl afirma que ele é 37x mais rápido que o Firecrawl auto-hospedado e usa 230x menos memória (11 MB em repouso). O README não publica metodologia de benchmark, então trate isso como alegações do fornecedor.

Se você conhece a API hospedada ou o Firecrawl CLI, a ideia é simples: as mesmas chamadas, respondidas na sua máquina.

Como o Firecrawl Local funciona: um binário, dez comandos

Cada recurso fica atrás de um subcomando de firecrawl-local. Aqui está a lista completa do README:

Comando O que ele faz Executa em
scrape <urls...> Faz scraping de uma ou mais URLs Sua máquina
crawl <url> Segue links a partir de uma URL inicial Sua máquina
map <url> Lista as URLs de um site a partir de sitemaps e da página inicial Sua máquina
serve Executa a API v2 do Firecrawl em localhost Sua máquina
mcp Executa o servidor MCP do Firecrawl via stdio Sua máquina, algumas ferramentas na nuvem
init Adiciona o servidor MCP a ferramentas de IA nesta máquina Sua máquina
search <query> Busca na web Firecrawl Cloud
find-tools <query> Encontra provedores de dados do Alexandria Firecrawl Cloud, login
data <provider> <capability> Executa um provedor de dados do Alexandria Firecrawl Cloud, login
login Faz login no Firecrawl no navegador Firecrawl Cloud

Três comandos cobrem a maior parte do uso diário:

# Print one page as markdown
firecrawl-local scrape https://example.com --markdown

# Crawl up to 50 pages and save one markdown file per page
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

# List every URL on a site
firecrawl-local map https://firecrawl.dev

Sem --markdown, o scrape imprime o JSON da API do Firecrawl. --format aceita markdown, html, rawHtml e links. PDFs e documentos do Office também são processados localmente.

Para páginas em JavaScript, ele usa o Chrome ou Chromium que você já tem. Sem um deles, páginas estáticas ainda funcionam, e uma página que precisaria de um navegador retorna um aviso. --browser auto|never|always decide quando o Chrome é usado.

O que roda localmente vs. no Firecrawl Cloud

Scraping, crawling, mapeamento e processamento de documentos rodam na sua máquina e não enviam nada para o Firecrawl. Três recursos vão para o Firecrawl Cloud porque um laptop não tem o índice, a rede ou os dados:

Firecrawl Local split: scrape, crawl, map and PDF and Office parsing run on your machine with optional Chrome, while search, the blocked-page fallback and Alexandria data go to Firecrawl Cloud under FIRECRAWL_CLOUD=auto, switchable to search or off

A variável de ambiente FIRECRAWL_CLOUD controla a transferência:

Valor Efeito
auto (padrão) Busca, o fallback de páginas bloqueadas e o Alexandria funcionam
search Apenas a busca vai para o Firecrawl Cloud
off Nada vai para o Firecrawl Cloud

Um valor não reconhecido conta como off. Resultados obtidos na nuvem carregam "source": "firecrawl-cloud"; se a nuvem também falhar, você recebe "blocked": true.

Chamadas à nuvem carregam um ID de instalação aleatório e o nome da ferramenta que fez a chamada, que é como o Firecrawl conta instalações.

Como instalar o Firecrawl Local

Você precisa de Rust e um compilador C. Depois:

  1. Instale as ferramentas de build. No macOS, execute xcode-select --install. No Debian ou Ubuntu, instale build-essential.
  2. Adicione o Chrome ou Chromium (opcional) se você precisar de páginas renderizadas em JavaScript ou capturas de tela.
  3. Adicione o Node.js 22 ou mais recente (opcional) se quiser o servidor MCP, que executa o pacote npm firecrawl-mcp via npx.
  4. Faça login (opcional) com firecrawl-local login para os provedores do Alexandria.

Instale o binário a partir do crates.io.

cargo install firecrawl-local
firecrawl-local --version

Para compilar o código mais recente, execute cargo build --release em apps/local de um clone do repositório.

API do Firecrawl Local: as rotas v2 em localhost:3002

firecrawl-local serve responde à API v2 do Firecrawl na porta 3002. Nenhuma chave de API é necessária para as rotas locais.

firecrawl-local serve

# in another terminal
curl -s http://localhost:3002/v2/scrape \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'

Estas rotas rodam na sua máquina:

Rota O que ela faz
POST /v2/scrape Faz scraping de uma URL
POST /v2/map Lista as URLs de um site
POST /v2/crawl, GET e DELETE /v2/crawl/{id} Inicia, verifica e cancela um crawl
POST /v2/batch/scrape, GET e DELETE /v2/batch/scrape/{id} Inicia, verifica e cancela um scraping em lote
GET /health Verificação de saúde

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

Código existente migra mudando apenas uma configuração: aponte a URL da API de qualquer SDK do Firecrawl para http://localhost:3002. Seu scraper ou pipeline de RAG mantém o código, e você para de gastar créditos na nuvem enquanto itera. Para uma visão mais ampla de pipelines de scraping, veja nosso guia de web scraping com Firecrawl.

O Firecrawl Local como servidor MCP para agentes de IA

firecrawl-local init registra o Firecrawl Local como um servidor Model Context Protocol em todas as ferramentas de IA que encontra. Ele conhece Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI e Codex, faz backup de cada arquivo de configuração antes, e aceita --dry-run para pré-visualizar mudanças ou --agent cursor para configurar uma ferramenta específica.

Seu agente recebe as ferramentas padrão do Firecrawl MCP: scrape, crawl, map e batch scrape rodam localmente, o resto vai para o Firecrawl Cloud.

Se seu agente navega em sites em que você não confia, registre-o como firecrawl-local mcp --public-only. Uma página com instruções ocultas poderia, caso contrário, levar o agente a abrir uma URL interna na sua rede.

Limites do Firecrawl Local

O Firecrawl Local não é o servidor Firecrawl completo. O README lista o que está faltando:

Para filas, workers e todos os formatos, o servidor completo em apps/api ainda existe, coberto no guia de auto-hospedagem do Firecrawl.

Padrões de segurança que você deveria conhecer

Os padrões variam por comando, porque serve recebe requisições de outros programas:

O Chrome roda headless e em sandbox com um perfil descartável. Ao fazer crawling, o Firecrawl Local lê o robots.txt conforme o Robots Exclusion Protocol, onde donos de sites podem se dirigir a ele como FirecrawlLocal.

Para quem é o Firecrawl Local

Encaixa menos se você depende de extração json, ações de navegador ou jobs de crawl de longa duração. Se você só precisa de busca para agentes, veja nossa compilação de busca na web open-source para o Claude.

Deixe seu agente de código testar a API local com o Apidog CLI

Quando o serve está rodando, você tem uma API HTTP real em localhost:3002. Antes de conectar um pipeline a ela, verifique se as rotas respondem como o seu código espera. Dê ao seu agente de código o Apidog CLI e um prompt em vez de clicar por requisições.

Configure uma vez:

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

Depois peça ao seu agente:

Start firecrawl-local serve in the background. Write an OpenAPI 3 file for its
local routes (POST /v2/scrape, POST /v2/map, GET /health) and import it into
Apidog project <id>. Create an environment pointing at http://localhost:3002,
add test cases that assert /health returns 200 and /v2/scrape returns
success: true with non-empty data.markdown for https://example.com, then run
them and summarize any failures.
Coding agent workflow: the agent starts firecrawl-local serve on localhost:3002, Apidog CLI imports the spec, creates test cases and runs them against POST /v2/scrape, POST /v2/map and GET /health, and writes a cli, json or junit report

O agente lê o schema, valida o payload e executa comandos como estes:

firecrawl-local serve &
apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file ./case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json

O Apidog CLI envia requisições a partir da sua máquina, então localhost:3002 é acessível. Troque -r cli,json por -r junit e a mesma execução entra no CI; nosso guia do Apidog CLI em pipelines CI/CD mostra a configuração, e Apidog CLI no Claude Code percorre o lado do agente. O plano gratuito do Apidog cobre equipes de até 4 usuários.

Perguntas frequentes

O Firecrawl Local é gratuito? O binário é open-source sob AGPL-3.0, e scraping, crawling e mapeamento locais não precisam de chave de API. A busca, o fallback de páginas bloqueadas e o Alexandria vão para o Firecrawl Cloud, e o Alexandria exige uma conta gratuita.

Posso usar o código existente do meu SDK do Firecrawl com o Firecrawl Local? Sim, para as rotas locais. Defina a URL da API do SDK como http://localhost:3002. Scrape, map, crawl e batch scrape rodam localmente; as rotas v0 e v1 não são servidas.

Como faço para o Firecrawl Local parar de chamar a nuvem? Defina FIRECRAWL_CLOUD=off. A busca e o fallback de páginas bloqueadas param de funcionar, e nada sai da sua máquina, exceto um login explícito.

Qual a diferença entre o Firecrawl Local e o Firecrawl auto-hospedado? O Firecrawl auto-hospedado é o servidor completo em apps/api, com filas, workers e todos os formatos. O Firecrawl Local é um binário único e mais leve que abre mão dos formatos json e summary, das ações de navegador e dos jobs persistentes.

Pratique o design de API no Apidog

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