Servidor MCP de Firecrawl

Una implementación de servidor del Model Context Protocol (MCP) que integra Firecrawl para web scraping. Nuestro servidor MCP es de código abierto y está disponible en GitHub.

Características

Web scraping, rastreo y descubrimiento
Búsqueda y extracción de contenido
Investigación avanzada y scraping por lotes
Compatibilidad en la nube y autogestionado
Compatibilidad con HTTP por streaming

Instalación

Puedes usar nuestra URL alojada de forma remota o ejecutar el servidor localmente. Obtén tu clave de API en https://firecrawl.dev/app/api-keys

URL alojada remotamente

https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

Ejecutar con npx

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Instalación manual

npm install -g firecrawl-mcp

Ejecutar en Cursor

Añadir el servidor MCP de Firecrawl a Cursor

Instalación manual

Configuración de Cursor 🖥️ Nota: Requiere Cursor versión 0.45.6+ Para ver las instrucciones de configuración más actualizadas, consulta la documentación oficial de Cursor sobre cómo configurar servidores MCP: Guía de configuración de servidores MCP de Cursor Para configurar Firecrawl MCP en Cursor v0.48.6

Abre la configuración de Cursor
Ve a Features > MCP Servers
Haz clic en ”+ Add new global MCP server”

Ingresa el siguiente código:

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Para configurar Firecrawl MCP en Cursor v0.45.6

Abre la configuración de Cursor
Ve a Features > MCP Servers
Haz clic en ”+ Add New MCP Server”
Ingresa lo siguiente:
- Name: “firecrawl-mcp” (o el nombre que prefieras)
- Type: “command”
- Command: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

Si usas Windows y tienes problemas, prueba cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"

Reemplaza your-api-key por tu clave de API de Firecrawl. Si aún no tienes una, puedes crear una cuenta y obtenerla en https://www.firecrawl.dev/app/api-keys Después de agregarlo, actualiza la lista de servidores MCP para ver las nuevas tools. El Composer Agent usará Firecrawl MCP automáticamente cuando corresponda, pero puedes solicitarlo explícitamente describiendo tus necesidades de web scraping. Accede al Composer con Command+L (Mac), selecciona “Agent” junto al botón de envío e ingresa tu consulta.

Ejecutar en Windsurf

Añade esto a tu ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "TU_CLAVE_API"
      }
    }
  }
}

Ejecución en modo HTTP con streaming

Para ejecutar el servidor localmente usando transporte HTTP con streaming en lugar del transporte stdio predeterminado:

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Utiliza la URL: http://localhost:3000/v2/mcp o https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

Instalación con Smithery (versión anterior)

Para instalar Firecrawl para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

Ejecutar en VS Code

Para una instalación con un solo clic, haz clic en uno de los botones de instalación de abajo…

Para una instalación manual, añade el siguiente bloque JSON a tu archivo de configuración de usuario (JSON) en VS Code. Puedes hacerlo pulsando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Clave de API de Firecrawl",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Opcionalmente, también puedes añadirlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otras personas:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Clave de API de Firecrawl",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Nota: Algunos usuarios han informado de problemas al añadir el servidor MCP a VS Code debido a cómo valida JSON con un formato de esquema obsoleto (microsoft/vscode#155379). Esto afecta a varias herramientas MCP, incluida Firecrawl. Solución alternativa: Desactiva la validación de JSON en VS Code para permitir que el servidor MCP se cargue correctamente. Consulta la referencia: directus/directus#25906 (comment). El servidor MCP sigue funcionando correctamente cuando se invoca a través de otras extensiones, pero el problema se produce específicamente al registrarlo directamente en la lista de servidores MCP. Planeamos añadir instrucciones una vez que VS Code actualice su validación de esquemas.

Ejecución en Claude Desktop

Añade lo siguiente al archivo de configuración de Claude:

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ejecución en Claude Code

Agrega el servidor MCP de Firecrawl usando la CLI de Claude Code:

claude mcp add firecrawl -e FIRECRAWL_API_KEY=your-api-key -- npx -y firecrawl-mcp

Ejecutar en Google Antigravity

Google Antigravity te permite configurar servidores MCP directamente a través de la interfaz de Agent.

Abre el panel lateral de Agent en el Editor o en la vista de Agent Manager
Haz clic en el menú ”…” (Más acciones) y selecciona MCP Servers
Selecciona View raw config para abrir tu archivo local mcp_config.json
Añade la siguiente configuración:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY"
      }
    }
  }
}

Guarda el archivo y haz clic en Refresh en la interfaz de Antigravity MCP para ver las nuevas herramientas

Reemplaza YOUR_FIRECRAWL_API_KEY con tu clave de API de https://firecrawl.dev/app/api-keys.

Ejecución en n8n

Para conectar el servidor MCP de Firecrawl en n8n:

Obtén tu clave de API de Firecrawl en https://firecrawl.dev/app/api-keys
En tu flujo de trabajo de n8n, agrega un nodo AI Agent
En la configuración de AI Agent, agrega una nueva Tool
Selecciona MCP Client Tool como tipo de herramienta
Ingresa el endpoint del servidor MCP (reemplaza {YOUR_FIRECRAWL_API_KEY} con tu clave de API real):

  https://mcp.firecrawl.dev/{YOUR_FIRECRAWL_API_KEY}/v2/mcp

Configura Server Transport en HTTP Streamable
Configura Authentication en None
En Tools to include, puedes seleccionar All, Selected o All Except: esto pondrá a disposición las herramientas de Firecrawl (scrape, crawl, map, search, extract, etc.)

Para implementaciones autohospedadas, ejecuta el servidor MCP con npx y habilita el modo de transporte HTTP:

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp

Esto iniciará el servidor en http://localhost:3000/v2/mcp, que puedes usar en tu flujo de trabajo de n8n como endpoint. La variable de entorno HTTP_STREAMABLE_SERVER=true es necesaria, ya que n8n requiere transporte HTTP.

Configuración

Variables de entorno

Requisitos para la API en la nube

FIRECRAWL_API_KEY: Tu clave de API de Firecrawl
- Requerida al usar la API en la nube (por defecto)
- Opcional al usar una instancia autogestionada con FIRECRAWL_API_URL
FIRECRAWL_API_URL (opcional): Endpoint de API personalizado para instancias autogestionadas
- Ejemplo: https://firecrawl.your-domain.com
- Si no se proporciona, se usará la API en la nube (requiere clave de API)

Configuración opcional

Configuración de reintentos

FIRECRAWL_RETRY_MAX_ATTEMPTS: Número máximo de reintentos (predeterminado: 3)
FIRECRAWL_RETRY_INITIAL_DELAY: Espera inicial en milisegundos antes del primer reintento (predeterminado: 1000)
FIRECRAWL_RETRY_MAX_DELAY: Espera máxima en milisegundos entre reintentos (predeterminado: 10000)
FIRECRAWL_RETRY_BACKOFF_FACTOR: Multiplicador de backoff exponencial (predeterminado: 2)

Monitoreo del uso de créditos

FIRECRAWL_CREDIT_WARNING_THRESHOLD: Umbral de advertencia para el uso de créditos (predeterminado: 1000)
FIRECRAWL_CREDIT_CRITICAL_THRESHOLD: Umbral crítico para el uso de créditos (predeterminado: 100)

Ejemplos de configuración

Para usar la API en la nube con reintentos personalizados y seguimiento de créditos:

# Requerido para la API en la nube
export FIRECRAWL_API_KEY=your-api-key

# Configuración opcional de reintentos
export FIRECRAWL_RETRY_MAX_ATTEMPTS=5        # Aumenta el número máximo de reintentos
export FIRECRAWL_RETRY_INITIAL_DELAY=2000    # Comienza con un retraso de 2 s
export FIRECRAWL_RETRY_MAX_DELAY=30000       # Retraso máximo de 30 s
export FIRECRAWL_RETRY_BACKOFF_FACTOR=3      # Retroceso más agresivo

# Monitoreo opcional de créditos
export FIRECRAWL_CREDIT_WARNING_THRESHOLD=2000    # Advertencia a los 2000 créditos
export FIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500    # Crítico a los 500 créditos

Para instancias autoalojadas:

# Requerido para instalaciones autogestionadas
export FIRECRAWL_API_URL=https://firecrawl.tu-dominio.com

# Autenticación opcional para instalaciones autogestionadas
export FIRECRAWL_API_KEY=your-api-key  # Si tu instancia requiere autenticación

# Configuración personalizada de reintentos
export FIRECRAWL_RETRY_MAX_ATTEMPTS=10
export FIRECRAWL_RETRY_INITIAL_DELAY=500     # Comienza con reintentos más rápidos

Configuración personalizada con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE",

        "FIRECRAWL_RETRY_MAX_ATTEMPTS": "5",
        "FIRECRAWL_RETRY_INITIAL_DELAY": "2000",
        "FIRECRAWL_RETRY_MAX_DELAY": "30000",
        "FIRECRAWL_RETRY_BACKOFF_FACTOR": "3",

        "FIRECRAWL_CREDIT_WARNING_THRESHOLD": "2000",
        "FIRECRAWL_CREDIT_CRITICAL_THRESHOLD": "500"
      }
    }
  }
}

Configuración del sistema

El servidor incluye varios parámetros configurables que se pueden establecer mediante variables de entorno. Estos son los valores predeterminados en caso de no configurarse:

const CONFIG = {
  retry: {
    maxAttempts: 3, // Number of retry attempts for rate-limited requests
    initialDelay: 1000, // Initial delay before first retry (in milliseconds)
    maxDelay: 10000, // Maximum delay between retries (in milliseconds)
    backoffFactor: 2, // Multiplier for exponential backoff
  },
  credit: {
    warningThreshold: 1000, // Warn when credit usage reaches this level
    criticalThreshold: 100, // Alerta crítica cuando el uso de créditos alcance este nivel
  },
};

Estas configuraciones controlan:

Comportamiento de reintentos
- Reintenta automáticamente las solicitudes fallidas debido a límites de velocidad (rate limits)
- Usa backoff exponencial para evitar sobrecargar la API
- Ejemplo: con la configuración predeterminada, los reintentos se realizarán en:
  - 1.er reintento: 1 segundo de espera
  - 2.º reintento: 2 segundos de espera
  - 3.er reintento: 4 segundos de espera (limitado por maxDelay)
Monitoreo del uso de créditos
- Supervisa el consumo de créditos de la API para uso en la nube
- Proporciona avisos al alcanzar umbrales específicos
- Ayuda a prevenir interrupciones inesperadas del servicio
- Ejemplo: con la configuración predeterminada:
  - Aviso con 1000 créditos restantes
  - Alerta crítica con 100 créditos restantes

Limitación de tasa y procesamiento por lotes

El servidor utiliza las capacidades integradas de limitación de tasa y procesamiento por lotes de Firecrawl:

Gestión automática de límites de tasa con backoff exponencial
Procesamiento paralelo eficiente para operaciones por lotes
Encolado y regulación inteligente de solicitudes
Reintentos automáticos ante errores transitorios

Herramientas disponibles

1. Herramienta de scraping (`firecrawl_scrape`)

Extrae contenido de una única URL con opciones avanzadas.

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formatos": ["markdown"],
    "onlyMainContent": true,
    "waitFor": 1000,
    "timeout": 30000,
    "mobile": false,
    "includeTags": ["article", "main"],
    "excludeTags": ["nav", "footer"],
    "skipTlsVerification": false
  }
}

2. Herramienta de scraping por lotes (`firecrawl_batch_scrape`)

Realiza scraping de varias URL de forma eficiente gracias a la limitación de velocidad integrada y al procesamiento en paralelo.

{
  "name": "firecrawl_batch_scrape",
  "arguments": {
    "urls": ["https://example1.com", "https://example2.com"],
    "options": {
      "formats": ["markdown"],
      "onlyMainContent": true
    }
  }
}

La respuesta incluye el ID de la operación para consultar su estado:

{
  "content": [
    {
      "type": "text",
      "text": "Operación por lotes en cola con ID: batch_1. Usa firecrawl_check_batch_status para verificar el progreso."
    }
  ],
  "isError": false
}

3. Comprobar el estado de un lote (`firecrawl_check_batch_status`)

Consulta el estado de una operación por lotes.

{
  "name": "firecrawl_check_batch_status",
  "arguments": {
    "id": "batch_1"
  }
}

4. Herramienta de mapeo (`firecrawl_map`)

Mapea un sitio web para descubrir todas las URL indexadas del sitio.

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com",
    "search": "blog",
    "sitemap": "include",
    "includeSubdomains": false,
    "limit": 100,
    "ignoreQueryParameters": true
  }
}

Opciones de Map Tool:

url: La URL base del sitio web a mapear
search: Término de búsqueda opcional para filtrar URL
sitemap: Controla el uso del sitemap: “include”, “skip” o “only”
includeSubdomains: Indica si se deben incluir subdominios en el mapeo
limit: Número máximo de URL a devolver
ignoreQueryParameters: Indica si se deben ignorar los parámetros de consulta al mapear

Mejor para: Descubrir URL en un sitio web antes de decidir qué datos extraer; encontrar secciones específicas de un sitio web. Devuelve: Array de URL encontradas en el sitio.

5. Search Tool (`firecrawl_search`)

Busca en la web y, opcionalmente, extrae contenido de los resultados de búsqueda.

{
  "name": "firecrawl_search",
  "arguments": {
    "query": "tu consulta de búsqueda",
    "limit": 5,
    "lang": "en",
    "country": "us",
    "scrapeOptions": {
      "formats": ["markdown"],
      "onlyMainContent": true
    }
  }
}

6. Herramienta de rastreo (`firecrawl_crawl`)

Inicia un rastreo asíncrono con opciones avanzadas.

{
  "name": "firecrawl_crawl",
  "arguments": {
    "url": "https://example.com",
    "maxDepth": 2,
    "limit": 100,
    "allowExternalLinks": false,
    "deduplicateSimilarURLs": true
  }
}

7. Comprobar el estado del rastreo (`firecrawl_check_crawl_status`)

Comprueba el estado de una tarea de rastreo.

{
  "name": "firecrawl_check_crawl_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Devuelve: Estado y progreso de la tarea de rastreo, incluidos los resultados si están disponibles.

8. Herramienta de extracción (`firecrawl_extract`)

Extrae información estructurada de páginas web usando capacidades de LLM. Es compatible tanto con extracción mediante IA en la nube como con LLM autoalojados.

{
  "name": "firecrawl_extract",
  "arguments": {
    "urls": ["https://example.com/page1", "https://example.com/page2"],
    "prompt": "Extract product information including name, price, and description",
    "systemPrompt": "You are a helpful assistant that extracts product information",
    "schema": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "price": { "type": "number" },
        "description": { "type": "string" }
      },
      "required": ["name", "price"]
    },
    "allowExternalLinks": false,
    "enableWebSearch": false,
    "includeSubdomains": false
  }
}

Ejemplo de respuesta:

{
  "content": [
    {
      "type": "text",
      "text": {
        "name": "Example Product",
        "price": 99.99,
        "description": "This is an example product description"
      }
    }
  ],
  "isError": false
}

Opciones de la herramienta Extract:

urls: Matriz de URLs de las que extraer información
prompt: Prompt personalizado para la extracción con el LLM
systemPrompt: Prompt del sistema para guiar al LLM
schema: Esquema JSON para la extracción de datos estructurados
allowExternalLinks: Permite la extracción desde enlaces externos
enableWebSearch: Habilita la búsqueda web para obtener contexto adicional
includeSubdomains: Incluye subdominios en la extracción

Al usar una instancia autogestionada (self-hosted), la extracción utilizará tu LLM configurado. Para la API en la nube, se usa el servicio de LLM gestionado de Firecrawl.

Sistema de registro

El servidor incluye un sistema de registro completo:

Estado y progreso de las operaciones
Métricas de rendimiento
Monitoreo del uso de créditos
Seguimiento de los límites de tasa
Condiciones de error

Ejemplos de mensajes de registro:

[INFO] Servidor MCP de Firecrawl inicializado correctamente
[INFO] Iniciando scrape para la URL: https://example.com
[INFO] Operación por lotes en cola con ID: batch_1
[WARNING] El uso de créditos alcanzó el umbral de aviso
[ERROR] Límite de solicitudes excedido, reintentando en 2 s...

Manejo de errores

El servidor ofrece un manejo de errores sólido:

Reintentos automáticos para errores transitorios
Manejo de límites de solicitudes con backoff
Mensajes de error detallados
Avisos sobre consumo de créditos
Resiliencia ante errores de red

Ejemplo de respuesta de error:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Límite de velocidad excedido. Reintentando en 2 segundos..."
    }
  ],
  "isError": true
}

Desarrollo

# Instalar dependencias
npm install

# Construir
npm run build

# Ejecutar tests
npm test

Cómo contribuir

Haz un fork del repositorio
Crea una rama para tu funcionalidad
Ejecuta las pruebas: npm test
Envía un pull request

Gracias a los colaboradores

Gracias a @vrknetha y @cawstudios por la implementación inicial. Gracias a MCP.so y Klavis AI por alojar el servicio, y a @gstarwd, @xiangkaiz y @zihaolin96 por integrar nuestro servidor.

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles

Primeros pasos

Novedades

Funciones principales

Webhooks

Guías para desarrolladores

Casos de uso

Cómo contribuir

​Características

​Instalación

​URL alojada remotamente

​Ejecutar con npx

​Instalación manual

​Ejecutar en Cursor

​Instalación manual

​Ejecutar en Windsurf

​Ejecución en modo HTTP con streaming

​Instalación con Smithery (versión anterior)

​Ejecutar en VS Code

​Ejecución en Claude Desktop

​Ejecución en Claude Code

​Ejecutar en Google Antigravity

​Ejecución en n8n

​Configuración

​Variables de entorno

​Requisitos para la API en la nube

​Configuración opcional

Configuración de reintentos

Monitoreo del uso de créditos

​Ejemplos de configuración

​Configuración personalizada con Claude Desktop

​Configuración del sistema

​Limitación de tasa y procesamiento por lotes

​Herramientas disponibles

​1. Herramienta de scraping (firecrawl_scrape)

​2. Herramienta de scraping por lotes (firecrawl_batch_scrape)

​3. Comprobar el estado de un lote (firecrawl_check_batch_status)

​4. Herramienta de mapeo (firecrawl_map)

​Opciones de Map Tool:

​5. Search Tool (firecrawl_search)

​6. Herramienta de rastreo (firecrawl_crawl)

​7. Comprobar el estado del rastreo (firecrawl_check_crawl_status)

​8. Herramienta de extracción (firecrawl_extract)

​Opciones de la herramienta Extract:

​Sistema de registro

​Manejo de errores

​Desarrollo

​Cómo contribuir

​Gracias a los colaboradores

​Licencia

Características

Instalación

URL alojada remotamente

Ejecutar con npx

Instalación manual

Ejecutar en Cursor

Instalación manual

Ejecutar en Windsurf

Ejecución en modo HTTP con streaming

Instalación con Smithery (versión anterior)

Ejecutar en VS Code

Ejecución en Claude Desktop

Ejecución en Claude Code

Ejecutar en Google Antigravity

Ejecución en n8n

Configuración

Variables de entorno

Requisitos para la API en la nube

Configuración opcional

Ejemplos de configuración

Configuración personalizada con Claude Desktop

Configuración del sistema

Limitación de tasa y procesamiento por lotes

Herramientas disponibles

1. Herramienta de scraping (`firecrawl_scrape`)

2. Herramienta de scraping por lotes (`firecrawl_batch_scrape`)

3. Comprobar el estado de un lote (`firecrawl_check_batch_status`)

4. Herramienta de mapeo (`firecrawl_map`)

Opciones de Map Tool:

5. Search Tool (`firecrawl_search`)

6. Herramienta de rastreo (`firecrawl_crawl`)

7. Comprobar el estado del rastreo (`firecrawl_check_crawl_status`)

8. Herramienta de extracción (`firecrawl_extract`)

Opciones de la herramienta Extract:

Sistema de registro

Manejo de errores

Desarrollo

Cómo contribuir

Gracias a los colaboradores

Licencia