¿Qué es Firecrawl Local? Ejecuta Firecrawl en tu propia máquina

Firecrawl Local es un único binario de Rust que hace scraping y crawling de sitios web, los mapea a markdown en tu propia máquina y sirve la API de Firecrawl v2 en localhost:3002. Aquí tienes lo que se ejecuta localmente, lo que va a la nube, cómo instalarlo y cuáles son sus limitaciones.

INEZA Felin-Michel

INEZA Felin-Michel

19 November 2026

¿Qué es Firecrawl Local? Ejecuta Firecrawl en tu propia máquina

Apidog para empresas

Despliegue local

SSO & RBAC

Conforme con SOC 2

Explorar Apidog Enterprise

Firecrawl Local es un único binario de Rust que hace scraping, crawling y mapeo de sitios web a markdown limpio en tu propia máquina. Se instala con cargo install firecrawl-local y puede servir la API v2 de Firecrawl en localhost:3002 sin clave de API, sin base de datos, sin cola y sin contenedor. La búsqueda y algunas otras funciones todavía recurren a Firecrawl Cloud, y puedes desactivarlo.

A continuación: qué se ejecuta en tu portátil, qué va a la nube, cómo instalarlo, las rutas de API que sirve, sus límites y cómo permitir que tu agente de programación pruebe la API local con Apidog CLI.

¿Qué es Firecrawl Local?

Firecrawl Local es la edición de código abierto y en el dispositivo de Firecrawl. Es un solo binario que obtiene páginas web, las limpia con el mismo código de limpieza de HTML que usa la API alojada de Firecrawl y devuelve markdown, HTML o enlaces. Se ejecuta como CLI, como servidor MCP para agentes de IA o como copia local de la API v2 de Firecrawl.

Firecrawl lo anunció el 18 de noviembre de 2026 en una publicación de lanzamiento en X, y el código está en la carpeta apps/local del repositorio de Firecrawl. El paquete está publicado en crates.io como firecrawl-local, y el repositorio tiene licencia AGPL-3.0.

Firecrawl afirma que es 37 veces más rápido que Firecrawl autoalojado y que usa 230 veces menos memoria (11 MB en reposo). El README no publica ningún método de benchmark, así que conviene tomarlo como afirmaciones del proveedor.

Si conoces la API alojada o la CLI de Firecrawl, la idea es sencilla: las mismas llamadas, respondidas en tu máquina.

Cómo funciona Firecrawl Local: un binario, diez comandos

Cada función está detrás de un subcomando de firecrawl-local. Esta es la lista completa del README:

Comando Qué hace Se ejecuta en
scrape <urls...> Hace scraping de una o varias URL Tu máquina
crawl <url> Sigue enlaces desde una URL de inicio Tu máquina
map <url> Lista las URL de un sitio a partir de los sitemaps y la página de inicio Tu máquina
serve Ejecuta la API v2 de Firecrawl en localhost Tu máquina
mcp Ejecuta el servidor MCP de Firecrawl por stdio Tu máquina, algunas herramientas en la nube
init Añade el servidor MCP a las herramientas de IA de esta máquina Tu máquina
search <query> Busca en la web Firecrawl Cloud
find-tools <query> Busca proveedores de datos de Alexandria Firecrawl Cloud, inicio de sesión
data <provider> <capability> Ejecuta un proveedor de datos de Alexandria Firecrawl Cloud, inicio de sesión
login Inicia sesión en Firecrawl en el navegador Firecrawl Cloud

Tres comandos cubren la mayor parte del uso diario:

# 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

Sin --markdown, scrape imprime el JSON de la API de Firecrawl. --format acepta markdown, html, rawHtml y links. Los PDF y los documentos de Office también se procesan localmente.

Para páginas con JavaScript, utiliza el Chrome o Chromium que ya tengas. Sin uno, las páginas estáticas siguen funcionando y una página que necesitaba un navegador devuelve una advertencia. --browser auto|never|always decide cuándo se usa Chrome.

Qué se ejecuta localmente y qué en Firecrawl Cloud

El scraping, el crawling, el mapeo y el procesamiento de documentos se ejecutan en tu máquina y no envían nada a Firecrawl. Tres funciones van a Firecrawl Cloud porque un portátil no tiene el índice, la red ni los datos:

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

La variable de entorno FIRECRAWL_CLOUD controla el traspaso:

Valor Efecto
auto (predeterminado) Funcionan la búsqueda, el recurso alternativo para páginas bloqueadas y Alexandria
search Solo la búsqueda va a Firecrawl Cloud
off Nada va a Firecrawl Cloud

Un valor no reconocido cuenta como off. Los resultados obtenidos de la nube llevan "source": "firecrawl-cloud"; si la nube también falla, obtienes "blocked": true.

Las llamadas a la nube llevan un ID de instalación aleatorio y el nombre de la herramienta que llama, que es como Firecrawl cuenta las instalaciones.

Cómo instalar Firecrawl Local

Necesitas Rust y un compilador de C. Después:

  1. Instala las herramientas de compilación. En macOS ejecuta xcode-select --install. En Debian o Ubuntu instala build-essential.
  2. Añade Chrome o Chromium (opcional) si necesitas páginas renderizadas con JavaScript o capturas de pantalla.
  3. Añade Node.js 22 o superior (opcional) si quieres el servidor MCP, que ejecuta el paquete npm firecrawl-mcp mediante npx.
  4. Inicia sesión (opcional) con firecrawl-local login para los proveedores de Alexandria.

Instala el binario desde crates.io.

cargo install firecrawl-local
firecrawl-local --version

Para compilar el código más reciente, ejecuta cargo build --release en apps/local de un clon del repositorio.

La API de Firecrawl Local: las rutas v2 en localhost:3002

firecrawl-local serve responde a la API v2 de Firecrawl en el puerto 3002. No se necesita clave de API para las rutas locales.

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 rutas se ejecutan en tu máquina:

Ruta Qué hace
POST /v2/scrape Hace scraping de una URL
POST /v2/map Lista las URL de un sitio
POST /v2/crawl, GET y DELETE /v2/crawl/{id} Inicia, consulta y cancela un crawl
POST /v2/batch/scrape, GET y DELETE /v2/batch/scrape/{id} Inicia, consulta y cancela un scraping por lotes
GET /health Comprobación de estado

Cualquier otra ruta /v2, como /v2/search, se reenvía a Firecrawl Cloud salvo que FIRECRAWL_CLOUD indique lo contrario. Las rutas v0 y v1 no se sirven.

El código existente se migra cambiando un solo ajuste: apunta la URL de la API de cualquier SDK de Firecrawl a http://localhost:3002. Tu scraper o pipeline de RAG conserva su código y dejas de gastar créditos de la nube mientras iteras. Para una visión más amplia de los pipelines de scraping, consulta nuestra guía de web scraping con Firecrawl.

Firecrawl Local como servidor MCP para agentes de IA

firecrawl-local init registra Firecrawl Local como servidor de Model Context Protocol en todas las herramientas de IA que encuentra. Reconoce Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI y Codex, hace una copia de seguridad de cada archivo de configuración antes de modificarlo y admite --dry-run para previsualizar los cambios o --agent cursor para configurar una sola herramienta.

Tu agente obtiene las herramientas estándar del MCP de Firecrawl: el scraping, el crawling, el mapeo y el scraping por lotes se ejecutan localmente, y el resto va a Firecrawl Cloud.

Si tu agente navega por sitios en los que no confías, regístralo como firecrawl-local mcp --public-only. De lo contrario, una página con instrucciones ocultas podría dirigir al agente a abrir una URL interna de tu red.

Límites de Firecrawl Local

Firecrawl Local no es el servidor Firecrawl completo. El README enumera lo que falta:

Para colas, workers y todos los formatos, el servidor completo en apps/api sigue existiendo, cubierto en la guía de autoalojamiento de Firecrawl.

Valores predeterminados de seguridad que deberías conocer

Los valores predeterminados varían según el comando, porque serve recibe solicitudes de otros programas:

Chrome se ejecuta en modo headless y en un sandbox con un perfil desechable. Al hacer crawling, Firecrawl Local lee robots.txt según el Protocolo de exclusión de robots, donde los propietarios de sitios pueden dirigirse a él como FirecrawlLocal.

Para quién es Firecrawl Local

Encaja peor si dependes de la extracción con json, de acciones de navegador o de trabajos de crawl de larga duración. Si solo necesitas búsqueda para agentes, consulta nuestra recopilación de búsqueda web de código abierto para Claude.

Deja que tu agente de programación pruebe la API local con Apidog CLI

Cuando serve se está ejecutando, tienes una API HTTP real en localhost:3002. Antes de conectar un pipeline, comprueba que las rutas responden como espera tu código. Dale a tu agente de programación Apidog CLI y un solo prompt en lugar de ir haciendo clic en cada solicitud.

Configúralo una vez:

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

Después pídeselo a tu 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

El agente lee el esquema, valida su payload y ejecuta comandos como estos:

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

Apidog CLI envía las solicitudes desde tu máquina, así que localhost:3002 es accesible. Cambia -r cli,json por -r junit y la misma ejecución se integra en CI; nuestra guía de Apidog CLI para pipelines de CI/CD muestra la configuración, y Apidog CLI en Claude Code recorre el lado del agente. El plan gratuito de Apidog cubre equipos de hasta 4 usuarios.

Preguntas frecuentes

¿Firecrawl Local es gratuito? El binario es de código abierto bajo AGPL-3.0, y el scraping, el crawling y el mapeo locales no necesitan clave de API. La búsqueda, el recurso alternativo para páginas bloqueadas y Alexandria van a Firecrawl Cloud, y Alexandria requiere una cuenta gratuita.

¿Puedo usar el código de mi SDK de Firecrawl existente con Firecrawl Local? Sí, para las rutas locales. Configura la URL de la API del SDK en http://localhost:3002. El scraping, el mapeo, el crawling y el scraping por lotes se ejecutan localmente; las rutas v0 y v1 no se sirven.

¿Cómo evito que Firecrawl Local llame a la nube? Establece FIRECRAWL_CLOUD=off. La búsqueda y el recurso alternativo para páginas bloqueadas dejan de funcionar, y nada sale de tu máquina excepto un login explícito.

¿En qué se diferencia Firecrawl Local de Firecrawl autoalojado? Firecrawl autoalojado es el servidor completo en apps/api, con colas, workers y todos los formatos. Firecrawl Local es un único binario más ligero que prescinde de los formatos json y summary, de las acciones de navegador y de los trabajos persistentes.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs