¡Hola! Soy Hoda.

“Quiero que mi agente de IA pueda leer páginas web, pero me preocupan las API de pago por uso y configurar un servidor me parece un dolor de cabeza.”

Pensando en esta situación exacta, Firecrawl anunció Firecrawl Local el 18 de noviembre de 2026.

Firecrawl Local es un único ejecutable binario que corre directamente en tu propio ordenador y se encarga del scraping de páginas web, del rastreo (crawling) y del mapeo (listar las URL de un sitio web). No necesita base de datos, ni colas de procesamiento, ni Docker, y puede conectarse a agentes de IA como Claude Code o Cursor a través del protocolo MCP.

En este artículo analizaremos qué puede y qué no puede hacer Firecrawl Local, cómo instalarlo y usarlo, y en qué se diferencia respecto a la versión autohospedada (Self-hosted) y a Firecrawl Cloud.

¿Qué es Firecrawl Local?

Firecrawl Local es un binario independiente escrito en Rust que te permite ejecutar las funciones de scraping de Firecrawl de forma local.

Firecrawl Local

Descarga las páginas y extrae únicamente el contenido principal en formato Markdown limpio, todo procesado en tu propia máquina. La limpieza y estructuración del HTML utiliza el mismo procesamiento que la API de Firecrawl.

Existen tres formas principales de utilizarlo:

  • Como interfaz de línea de comandos (CLI), ejecutando scrape / crawl / map desde la terminal.
  • Como servidor MCP, proporcionando herramientas directamente a tu agente de IA.
  • Como una versión local de la API Firecrawl v2, ejecutándose en localhost:3002.

Para la tercera opción, solo necesitas cambiar la URL base de la API en tu SDK de Firecrawl a http://localhost:3002. Las rutas locales no requieren ninguna clave de API (API key).

Puntos clave del anuncio oficial

El comunicado oficial destaca los siguientes aspectos:

  • Ejecuta funciones de scrape / crawl / map basadas en Rust en tu propia máquina.
  • 37 veces más rápido que la versión autohospedada.
  • Consumo de memoria 230 veces menor (alrededor de 11 MB en reposo).
  • 100 % código abierto (open source).
  • Compatible de forma nativa con los SDK y el servidor MCP existentes de Firecrawl.

Qué se procesa localmente y qué se envía a la nube

Firecrawl Local no funciona de manera 100 % local en todos los escenarios. A continuación te mostramos el desglose de dónde se procesa cada función.

FunciónDónde se ejecutaNotas
scrape (página individual)En tu PCHTML / rawHTML / Markdown / enlaces
crawl (seguir enlaces en un sitio)En tu PCRespeta la normativa de robots.txt
map (listar las URL de un sitio)En tu PCSe genera a partir del sitemap y la página inicial
batch scrape (scraping en lote)En tu PCExtrae múltiples URL de forma simultánea
Procesamiento de PDF y documentos de OfficeEn tu PCSe analizan y convierten localmente
Search (búsqueda web)Firecrawl CloudFunciona sin cuenta, aunque con límites de uso
Reintento de páginas bloqueadasFirecrawl CloudAlternativa para sitios que tu PC no puede descargar directamente
Alexandria (proveedor de datos)Firecrawl CloudRequiere iniciar sesión con una cuenta gratuita

Las páginas que se envían a la nube a través de la búsqueda o los reintentos de sitios bloqueados se etiquetan con "source": "firecrawl-cloud" en los resultados, por lo que siempre podrás comprobar qué datos han salido de tu equipo.

Controla el envío a la nube con la variable de entorno FIRECRAWL_CLOUD

Puedes controlar qué información se envía a la nube mediante la variable de entorno FIRECRAWL_CLOUD.

ValorComportamiento
auto (predeterminado)Búsqueda, reintentos de páginas bloqueadas y Alexandria están disponibles
searchSolo las búsquedas se envían a la nube
offNada se envía a la nube

Para trabajos con información confidencial que no debe salir de tu equipo, como proyectos de clientes o investigación interna, establecer el valor en off es la opción más segura. En este modo, la función de búsqueda no estará disponible, por lo que tendrás que proporcionar tú mismo las URL que deseas analizar.

Cómo instalar Firecrawl Local

La instalación requiere Rust y un compilador de C. En macOS, ejecuta xcode-select --install. En Debian / Ubuntu, instala build-essential.

  1. Configurar Rust

Instala Rust desde rustup. Puedes saltarte este paso si ya lo tienes instalado.

  1. Instalar Firecrawl Local

Ejecuta el siguiente comando en tu terminal:

bash
cargo install firecrawl-local

La compilación tardará unos minutos. En una de nuestras pruebas, tardó poco menos de 6 minutos y el ejecutable binario resultante ocupó unos 19 MB.

  1. Verificar la instalación

Si se muestra el número de versión, todo está listo para funcionar.

bash
firecrawl-local --version

Aunque no son estrictamente obligatorios, es muy recomendable tener estos dos elementos:

  • Chrome o Chromium: Permite obtener páginas web que requieren renderizado con JavaScript. Las páginas estáticas funcionan sin problemas sin él.
  • Node.js 22 o posterior: Necesario para ejecutar el servidor MCP (firecrawl-mcp) mediante npx.

Uso básico (CLI)

Extraer una sola página en formato Markdown

bash
firecrawl-local scrape https://example.com --markdown

Sin la opción --markdown, la salida será el JSON estándar que devuelve la API de Firecrawl. También puedes especificar varios formatos a la vez, como --format markdown,links. Los formatos disponibles son markdown / html / rawHtml / links.

Rastrear un sitio web completo (crawl)

bash
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

Este comando sigue los enlaces del sitio hasta un límite de 50 páginas y guarda cada una como un archivo Markdown independiente en el directorio ./pages. El valor predeterminado para --limit es 100.

Obtener el listado de URL de un sitio (map)

bash
firecrawl-local map https://firecrawl.dev

Muestra una lista con las URL expuestas por el sitio. Es una función ideal para entender rápidamente la estructura de un sitio de documentación.

Usarlo como API local (serve)

bash
firecrawl-local serve

Inicia un servidor con la API v2 de Firecrawl en localhost:3002. Si utilizas el SDK de Python, por ejemplo, solo necesitas redirigir la URL de origen:

python
from firecrawl import Firecrawl

app = Firecrawl(api_url="http://localhost:3002")
print(app.scrape("https://example.com").markdown)

Estas son las rutas de la API disponibles de forma local:

  • POST /v2/scrape
  • POST /v2/map
  • POST /v2/crawl (admite verificación de estado y cancelación)
  • POST /v2/batch/scrape (admite verificación de estado y cancelación)
  • GET /health

Otras rutas de la versión /v2 (como /v2/search) se reenviarán a Firecrawl Cloud dependiendo de tu configuración. Las rutas v0 y v1 no son compatibles.

Conexión con agentes de IA (MCP)

Uno de los puntos fuertes de Firecrawl Local es lo sencillo que resulta conectarlo con agentes de IA.

bash
firecrawl-local init

Al ejecutar este comando una vez, la herramienta detecta las aplicaciones de IA instaladas en tu equipo y se registra automáticamente con ellas como un servidor MCP.

Soporta las siguientes herramientas:

  • Claude Code
  • Claude Desktop
  • Cursor
  • Windsurf
  • Gemini CLI
  • Codex

Los archivos de configuración se respaldan automáticamente antes de realizar cambios. Para previsualizar los cambios antes de aplicarlos, utiliza --dry-run. Si solo deseas configurar una herramienta específica, indícalo mediante --agent cursor. Tras ejecutar el comando, reinicia la aplicación correspondiente para cargar la nueva configuración.

Si prefieres realizar la configuración manual, registra firecrawl-local mcp como un servidor stdio MCP.

json
{
  "mcpServers": {
    "firecrawl": {
      "command": "/path/to/firecrawl-local",
      "args": ["mcp"]
    }
  }
}

El agente obtendrá las herramientas MCP estándar de Firecrawl. Las operaciones de Scrape, crawl, map y batch scrape se ejecutarán en tu PC, mientras que las demás herramientas se derivarán a Firecrawl Cloud.

Usa la opción —public-only al leer sitios no confiables

Cuando un agente de IA lee una página web, las instrucciones ocultas en el código de la página podrían intentar engañarlo para acceder a URL de tu red local. Esto se conoce como ataque de inyección de prompts (prompt injection).

Para protegerte frente a este riesgo, recomendamos registrar los agentes que analicen sitios web externos no confiables con la marca --public-only.

json
{
  "mcpServers": {
    "firecrawl": {
      "command": "/path/to/firecrawl-local",
      "args": ["mcp", "--public-only"]
    }
  }
}

Por diseño, scrape / crawl / mcp pueden acceder a tu propio equipo y a tu red interna. Con --public-only, se bloquea el acceso a localhost y a direcciones IP privadas. Ten en cuenta que las direcciones de metadatos de servicios en la nube y objetivos similares se bloquean siempre en cualquier modo.

Firecrawl Local vs. Self-Hosted vs. Cloud

Firecrawl ya contaba con las opciones “Self-hosted” (autohospedada) y “Cloud”. Firecrawl Local se suma como una tercera alternativa.

Firecrawl LocalSelf-hostedFirecrawl Cloud
ArquitecturaUn solo archivo binarioMúltiples servicios mediante Docker Compose (api / playwright-service / redis / rabbitmq / nuq-postgres)Sin instalación requerida
Facilidad de instalaciónSolo cargo installClonar repositorio, crear .env e iniciar DockerListo para usar inmediatamente
Búsqueda (Search)Reenviada a Firecrawl CloudSe ejecuta en tu propio entornoDisponible
Formatos json / summaryNo compatibles (se omiten con una advertencia)Disponibles configurando un LLM propioDisponibles
Capturas de pantallaPosibles usando ChromeRequiere Fire-engine (no incluido en la instalación estándar)Disponibles
Almacenamiento de tareasEn memoria (se borran tras 1 hora)Persistente en cola respaldada por PostgresDisponibles
Ideal paraDescargas ligeras en tu PC o para agentes de IATareas de larga duración o entornos aislados sin salidaUsuarios que buscan todas las funciones sin complicaciones técnicas

En resumen, esta es la forma recomendada de elegir:

  • Quieres probar la herramienta o permitir que un agente de IA lea la web → Firecrawl Local
  • Necesitas rastreos extensos, extracción estructurada con LLM o búsquedas aisladas en tu red → Self-hosted
  • Prefieres evitar configuraciones y mantenimientos, accediendo a todas las funciones → Firecrawl Cloud

Ten en cuenta que Firecrawl Local no reemplaza a la versión autohospedada. Se trata de un desarrollo independiente (apps/local dentro del repositorio). Puedes combinar ambos: Local en tu equipo de desarrollo y para tus agentes, y Self-hosted o Cloud para entornos de producción.

Aspectos a revisar al migrar desde Self-Hosted

Si ya utilizas la versión autohospedada y quieres cambiar la URL de tu SDK a la versión Local, verifica lo siguiente:

  • ¿Estás realizando llamadas a las API v0 o v1?
  • ¿Utilizas los formatos json / summary o capturas de pantalla actions?
  • ¿Consultas identificadores de crawl con más de una hora de antigüedad? (Las tareas de Local se almacenan en RAM y se borran tras 1 hora)
  • ¿Tu URL de verificación de estado apunta a /v0/health/readiness? (Local utiliza /health)

Limitaciones y consideraciones importantes

Firecrawl Local no es un servidor completo de Firecrawl. Es conveniente conocer sus limitaciones de antemano.

Ventajas 5
  • Un solo binario, sin necesidad de base de datos, colas ni Docker.

  • scrape / crawl / map / batch scrape son gratuitos y no requieren API key.

  • `firecrawl-local init` integra el protocolo MCP en los principales agentes de IA con un solo comando.

  • Los SDK y configuraciones MCP de Firecrawl funcionan cambiando únicamente la URL.

  • Con `FIRECRAWL_CLOUD=off`, garantizas que ningún dato se envíe a la nube.

Desventajas 6
  • Los formatos `json` y `summary` no están soportados (requieren procesamiento por un LLM).

  • Las capturas de pantalla del navegador `actions` son ignoradas.

  • Las tareas de crawl / batch residen en memoria y se borran tras 1 hora o al detener `serve`.

  • La búsqueda, el reintento de páginas bloqueadas y Alexandria requieren conexión a la nube.

  • No admite las versiones de API v0 / v1.

  • Requiere Rust y un compilador de C para la instalación.

La licencia del proyecto es AGPL-3.0. Para uso personal o interno no supone inconvenientes, pero si planeas modificar el código para integrarlo en un comercializable, te recomendamos revisar detenidamente los términos de la licencia.

¿Para quién es ideal Firecrawl Local?

Ideal para:

  • Usuarios que quieren que sus agentes de IA (Claude Code, Cursor, etc.) consulten sitios de documentación.
  • Personas que buscan hacer web scraping puntual en su equipo sin costes por uso ni mantenimiento de servidores.
  • Desarrolladores que prefieren no enviar URL a servidores externos, como al trabajar en proyectos de clientes.
  • Quienes desean ejecutar código escrito para los SDK de Firecrawl de forma local sin hacer cambios.

No recomendado para:

  • Procesos de rastreo masivos o de larga duración que no deban interrumpirse.
  • Proyectos que requieran extracción de datos estructurados mediante LLM (json / summary).
  • Casos donde las búsquedas deban ejecutarse 100 % dentro de la red local (la versión Self-hosted se adapta mejor a esto).
  • Usuarios que prefieran no instalar herramientas de desarrollo como Rust o compiladores de C (la versión Cloud es la opción más sencilla).

Preguntas frecuentes

¿Firecrawl Local es gratis?

Sí. Las funciones scrape / crawl / map / batch scrape se ejecutan localmente y no requieren clave de API. La búsqueda, el reintento de páginas bloqueadas y Alexandria utilizan la nube. Alexandria está disponible al iniciar sesión con una cuenta gratuita.

¿Necesito tener instalado Docker?

No. Se ejecuta como un único binario. Sin embargo, si necesitas renderizar páginas con mucho código JavaScript dentro de un contenedor, requerirás un perfil seccomp específico para ejecutar el sandbox de Chrome.

¿Se puede usar completamente sin conexión a la nube?

Sí. Al configurar FIRECRAWL_CLOUD=off, las operaciones scrape / crawl / map continuarán ejecutándose en tu PC normalmente. A cambio, las funciones de búsqueda, reintentos de páginas bloqueadas y Alexandria quedarán deshabilitadas.

¿Puede reemplazar a la versión Self-hosted?

Depende del uso. Para descargas ligeras en tu máquina o integración con agentes de IA, la versión Local es más que suficiente. Si requieres tareas en segundo plano persistentes o extracción mediante LLM, necesitarás la versión autohospedada.

¿Con qué herramientas de IA es compatible?

El comando firecrawl-local init admite Claude Code / Claude Desktop / Cursor / Windsurf / Gemini CLI / Codex. Cualquier otra aplicación compatible con el protocolo MCP puede conectarse registrando firecrawl-local mcp como un servidor stdio MCP.

Resumen

Firecrawl Local te permite llevar las funciones de scraping de Firecrawl directamente a tu PC en un único ejecutable binario.

  • Comienza rápidamente ejecutando cargo install firecrawl-local.
  • Las funciones scrape / crawl / map / batch scrape son gratuitas y no requieren API key.
  • Un solo comando init lo configura como servidor MCP en los principales agentes de IA.
  • Las funciones en la nube como la búsqueda se pueden activar o desactivar mediante FIRECRAWL_CLOUD.
  • json / summary y los trabajos persistentes de larga duración no son compatibles, por lo que se recomienda optar por Self-hosted o Cloud en esos casos.

Para empezar a probarlo, intenta extraer la información de algún sitio de documentación que utilices habitualmente.