Características
- Buscar en la web y obtener el contenido completo de la página
- Convertir cualquier URL en datos estructurados y limpios mediante scraping
- Procesar archivos locales como PDF, DOCX, XLSX y HTML
- Interactuar con páginas — hacer clic, navegar y operar
- Investigación avanzada con un agente autónomo
- Compatibilidad en la nube y autogestionado
- Compatibilidad con HTTP por streaming
Instalación
¿No tienes clave de API? Conéctate a
https://mcp.firecrawl.dev/v2/mcp para usar el plan Free remoto sin clave. Es gratis y tiene límite de tasa por IP; consulta Límites de tasa para ver la lista actual de herramientas sin clave. Configura FIRECRAWL_API_KEY para desbloquear todas las herramientas MCP y límites más altos.URL alojada remotamente
Authorization para desbloquear todas las herramientas y ofrecer límites superiores:
Ejecutar con npx
Instalación manual
Ejecutar en Cursor
O añádelo manualmente a ~/.cursor/mcp.json:
Ejecución local con una clave de API
- Abre la configuración de Cursor
- Ve a Features > MCP Servers
- Haz clic en ”+ Add new global MCP server”
- Ingresa el siguiente código:
- 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 MCP Servers para ver las nuevas tools. El Composer Agent usará Firecrawl MCP automáticamente cuando corresponda, pero puedes solicitarlo explícitamente describiendo tus necesidades de datos web. Accede al Composer con Command+L (Mac), selecciona “Agent” junto al botón de envío e ingresa tu consulta.
Ejecutar en Windsurf
./codeium/windsurf/model_config.json:
Ejecución en modo HTTP con streaming
stdio predeterminado:
Instalación con Smithery (versión anterior)
Ejecutar en VS Code
Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).
.vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otras personas:
Ejecutar en Claude Desktop
spawn npx ENOENT, Node.js no está instalado o no está en el PATH del sistema. Instala Node.js desde nodejs.org (versión LTS) y luego reinicia por completo Claude Desktop. En Windows, también puedes ejecutar where npx en el Símbolo del sistema y usar la ruta completa (por ejemplo, C:\\Program Files\\nodejs\\npx.cmd) como valor de command.
Ejecutar en Claude Code
Ejecutar en Google Antigravity

- 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:
- Guarda el archivo y haz clic en Refresh en la interfaz de Antigravity MCP para ver las nuevas herramientas
YOUR_FIRECRAWL_API_KEY con tu clave de API de https://firecrawl.dev/app/api-keys.
Ejecución 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:
- Configura Server Transport en HTTP Streamable
- Configura Authentication en Bearer y pega tu clave de API de Firecrawl, o déjalo en None para usar el plan Free sin clave
- 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.)
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
API en la nube y autogestionada
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)
- Ejemplo:
Ejemplos de configuración
Configuración personalizada con Claude Desktop
claude_desktop_config.json:
MCP alojado vs. MCP local
- El modo keyless alojado expone solo las herramientas compatibles con keyless y está sujeto a límites de tasa por IP.
- La lectura de archivos locales solo está disponible cuando ejecutas el MCP Server localmente.
- Los webhooks y las rutas de archivos locales deben configurarse desde un MCP Server local o autogestionado cuando el agente necesita acceso a recursos locales.
Límites de tasa
Herramientas disponibles
1. Herramienta de scraping (firecrawl_scrape)
redactPII en los argumentos de la herramienta de scraping.
2. Herramienta de mapeo (firecrawl_map)
Opciones de Map Tool:
url: La URL base del sitio web a mapearsearch: Término de búsqueda opcional para filtrar URLsitemap: Controla el uso del sitemap: “include”, “skip” o “only”includeSubdomains: Indica si se deben incluir subdominios en el mapeolimit: Número máximo de URL a devolverignoreQueryParameters: Indica si se deben ignorar los parámetros de consulta al mapear
3. Search Tool (firecrawl_search)
Opciones de la herramienta de búsqueda:
query: La cadena de consulta (obligatorio)limit: Número máximo de resultados a devolverlocation: Ubicación geográfica para los resultados de búsquedatbs: Filtro de búsqueda basado en tiempo (por ejemplo,qdr:dpara el último día,qdr:wpara la última semana,qdr:mpara el último mes)filter: Filtro de búsqueda adicionalsources: Array de tipos de fuentes a buscar (web,images,news)scrapeOptions: Opciones de scraping de las páginas de resultados de búsquedaenterprise: Array de opciones de enterprise (default,anon,zdr)
4. Herramienta para procesar (firecrawl_parse)
FIRECRAWL_API_URL, el servidor MCP puede leer filePath directamente y envía los bytes del archivo a /v2/parse.
Cuando usas el servidor MCP remoto alojado, ese servidor no puede leer archivos de tu máquina. En ese caso, firecrawl_parse usa un flujo de transferencia en dos pasos que también funciona con la URL remota sin clave:
- Llama a
firecrawl_parseconfilePath. La herramienta devuelve un comando de carga precompletado y unnextToolCallque contiene unuploadRef. - Ejecuta el comando de carga en la máquina que puede leer el archivo y, después, vuelve a llamar a
firecrawl_parsecon eluploadRefdevuelto.
Opciones de la herramienta Parse:
filePath: Ruta local del archivo que quieres procesar. Úsalo para la primera llamada.uploadRef: Referencia devuelta por la primera llamada a hosted-MCP. Úsala para la segunda llamada después de que la carga se complete correctamente.formats: Formatos de salida. El valor predeterminado esmarkdown.parsers: Controles del analizador, como las opciones de procesamiento de PDF.contentType: Anulación opcional del tipo MIME del archivo.declaredSizeBytes: Tamaño declarado opcional del archivo. Los archivos están limitados a 50 MB.
firecrawl_scrape en su lugar; detectará y procesará documentos desde URL.
5. Herramienta de rastreo (firecrawl_crawl)
6. Comprobar el estado del rastreo (firecrawl_check_crawl_status)
7. Herramienta de extracción (firecrawl_extract)
Opciones de la herramienta Extract:
urls: Matriz de URLs de las que extraer informaciónprompt: Prompt personalizado para la extracción con el LLMschema: Esquema JSON para la extracción de datos estructuradosallowExternalLinks: Permite la extracción desde enlaces externosenableWebSearch: Habilita la búsqueda web para obtener contexto adicionalincludeSubdomains: Incluye subdominios en la extracción
8. Herramienta del agente (firecrawl_agent)
firecrawl_agent_status para comprobar cuándo se completa y recuperar los resultados.
Opciones de la herramienta del agente:
prompt: Descripción en lenguaje natural de los datos que quieres (obligatorio, máximo 10.000 caracteres)urls: Matriz opcional de URLs para enfocar el agente en páginas específicasschema: Esquema JSON opcional para una salida estructurada
scrape normal.
Devuelve: ID de la tarea para comprobación del estado. Usa firecrawl_agent_status para consultar periódicamente los resultados.
9. Comprobar el estado del agente (firecrawl_agent_status)
Opciones de estado del agente:
id: El ID del trabajo del agente devuelto porfirecrawl_agent(obligatorio)
processing: El agente sigue investigando; continúa consultandocompleted: Investigación finalizada; la respuesta incluye los datos extraídosfailed: Se produjo un error
10. Interact con una página (firecrawl_interact)
- Pasa
urlpara abrir e interactuar con una página nueva en una sola llamada a MCP. - Pasa
scrapeIdde una llamada anterior afirecrawl_scrapepara reutilizar la página ya cargada.
url y scrapeId a la vez. Proporciona prompt o code. scrapeOptions solo puede usarse con el modo url.
Ejemplo del modo URL:
Opciones de la herramienta Interact:
url: Página con la que interactuar; abre la sesión por ti. Usa esto oscrapeId.scrapeId: El ID del trabajo de scraping de una llamada previa afirecrawl_scrape. Usa esto ourl.prompt: Instrucción en lenguaje natural que describe la acción que se debe realizar. Indicapromptocode.code: Código que se ejecutará en la sesión del navegador. Indicacodeoprompt.language:bash,pythononode(opcional; el valor predeterminado esnode; solo se usa concode)timeout: Tiempo de espera de ejecución en segundos, 1–300 (opcional; el valor predeterminado es 30)scrapeOptions: Controles de scraping opcionales que se usan solo con el modourl.
11. Detener una sesión de Interact (firecrawl_interact_stop)
Opciones para detener Interact:
scrapeId: El ID de scraping de la sesión que se va a detener (obligatorio)
Sistema de registro
- 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
Manejo de errores
- 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
Desarrollo
Cómo contribuir
- Haz un fork del repositorio
- Crea una rama para tu funcionalidad
- Ejecuta las pruebas:
npm test - Envía un pull request

