Herramientas de Firecrawl MCP

Firecrawl MCP ofrece herramientas para encontrar, extraer, interactuar con y supervisar contenido web. Tu cliente MCP recibe el esquema de entrada exacto de cada herramienta disponible al conectarse.

Disponibilidad de herramientas#

Modo de conexión	Herramientas disponibles
OAuth alojado	Conjunto completo de herramientas, sujeto al plan y a la política del equipo
clave de API alojada	Conjunto completo de herramientas, sujeto al plan y a la política del equipo
Sin clave alojado	`firecrawl_search`, `firecrawl_scrape` y `firecrawl_parse`
Local con la API en la nube de Firecrawl	Herramientas respaldadas por API; el procesamiento directo de archivos locales no está disponible
Local con una API de Firecrawl autogestionada	Herramientas compatibles con los servicios habilitados en esa implementación

Comienza con Primeros pasos y elige Para agentes o Para personas. Algunas herramientas opcionales pueden deshabilitarse mediante el entorno o la política del equipo.

Selecciona una herramienta#

Trabajo	Herramienta	Úsala cuando
Leer una página	`firecrawl_scrape`	Conoces la URL y necesitas el contenido de la página o campos estructurados.
Extraer datos estructurados	`firecrawl_scrape` con formato JSON	Tienes la URL y quieres datos que coincidan con un prompt o esquema JSON.
Descubrir las URL de un sitio	`firecrawl_map`	Necesitas encontrar páginas antes de decidir qué extraer.
Buscar en la web	`firecrawl_search`	Tienes una consulta en lugar de una URL conocida.
Procesar un archivo	`firecrawl_parse`	Necesitas contenido de un PDF, documento, hoja de cálculo o archivo HTML.
Extraer varias páginas	`firecrawl_crawl` y `firecrawl_check_crawl_status`	Necesitas recorrer un sitio o una sección. La herramienta de rastreo consulta el estado del trabajo hasta que alcanza un estado terminal antes de devolver el resultado.
Realizar investigación autónoma	`firecrawl_agent` y `firecrawl_agent_status`	La tarea abarca varias fuentes y se desconocen las páginas exactas.
Interactuar con una página activa	`firecrawl_interact` y `firecrawl_interact_stop`	Necesitas hacer clic, completar formularios, navegar o extraer contenido de páginas dinámicas.
Buscar literatura científica	`firecrawl_research_*`	Necesitas encontrar artículos, leer pasajes de uno de ellos o seguir citas. Busca en el Research Index resúmenes de artículos de PubMed, bioRxiv, medRxiv y arXiv.
Responder una pregunta de programación	`firecrawl_developer_search`	Necesitas respuestas de fuentes primarias procedentes de issues, pull requests fusionadas, archivos README y documentación seleccionada.
Supervisar cambios	`firecrawl_monitor_*`	Necesitas comprobaciones recurrentes, diffs y notificaciones por webhook o correo electrónico.
Enviar feedback sobre el producto	`firecrawl_search_feedback` y `firecrawl_feedback`	Quieres valorar resultados de búsqueda o informar sobre la calidad de un endpoint.

Note

La antigua herramienta MCP Extract está obsoleta y no forma parte del conjunto actual de herramientas. Usa Scrape con formato JSON para una página conocida, o Agent cuando Firecrawl deba descubrir las fuentes. Consulta Elegir el extractor de datos para ver la comparación completa.

Tip

Usa el esquema que muestra tu cliente MCP para los argumentos actuales. Las guías de funcionalidad a continuación explican el comportamiento subyacente de Firecrawl sin duplicar aquí esos esquemas.

Comportamiento importante#

Procesar un archivo local

Un MCP Server local conectado a una API de Firecrawl autogestionada puede leer filePath directamente. El servidor alojado no puede leer archivos de tu máquina, por lo que utiliza un proceso de dos llamadas:

Llama a firecrawl_parse con filePath para recibir un comando de carga y uploadRef.
Ejecuta el comando de carga en la máquina que puede leer el archivo.
Vuelve a llamar a firecrawl_parse con el uploadRef devuelto.

El comando de carga usa un objetivo firmado de corta duración y no contiene tu clave de API de Firecrawl. Usa firecrawl_scrape para una URL de documento pública.

Comprobar un rastreo en ejecución

firecrawl_crawl normalmente inicia un rastreo y consulta su estado hasta que alcanza un estado terminal antes de responder. Si se agota el tiempo de espera, reanuda el trabajo con firecrawl_check_crawl_status y el ID del rastreo. Usa la misma herramienta de estado para un rastreo creado fuera de la llamada MCP actual.

firecrawl_agent es asíncrono: devuelve un ID de trabajo y firecrawl_agent_status comprueba ese trabajo hasta que se complete o falle.

Cerrar sesiones de Interact

Comienza con una url o reutiliza el scrapeId de una llamada a Scrape anterior. Cuando finalice el flujo de trabajo, llama a firecrawl_interact_stop con el scrapeId para liberar la sesión.

Gestionar monitores de forma segura

La familia firecrawl_monitor_* crea, enumera, actualiza, ejecuta e inspecciona monitores recurrentes. firecrawl_monitor_delete elimina permanentemente un monitor y solo debe llamarse cuando el usuario tenga la intención explícita de eliminarlo.

Habilitar herramientas de feedback opcionales

Establece FIRECRAWL_NO_SEARCH_FEEDBACK=1 para evitar que se registre firecrawl_search_feedback. Establece FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 para evitar que se registre firecrawl_feedback.

Guía de funcionalidad#

Scrape

Extrae contenido o campos estructurados de una URL.

Encuentra fuentes relevantes en la web, noticias, imágenes y fuentes para desarrolladores.

Research Index

Busca artículos, lee pasajes y sigue citas.

Developer Index

Responde preguntas de programación a partir de issues, PRs, READMEs y documentación.

Rastreo

Recorre y extrae un sitio o una sección.

Procesar

Convierte archivos en salidas listas para LLM.

Interact

Opera páginas dinámicas en una sesión de navegador activa.

Agent

Realiza investigaciones autónomas en múltiples fuentes.

Monitoring

Supervisa cambios en las páginas y recibe notificaciones.

Solución de problemas#

Falta una herramienta: confirme el modo de conexión en Primeros pasos, vuelva a conectarse o reinicie el cliente y compruebe si la política del equipo deshabilita herramientas opcionales.
El cliente devuelve 401: primero compruebe la URL del servidor configurada.
- Si la URL configurada es /v2/mcp-oauth, vuelva a iniciar sesión a través del cliente.
- Si es /v2/mcp, reemplace la clave de API en ese servidor o actualice la URL del servidor existente a /v2/mcp-oauth y complete el inicio de sesión.
- Inicie una nueva sesión de cliente después de cualquiera de los cambios.

El cliente ha alcanzado el límite de tasa: consulte los límites de tasa actuales, espere el intervalo antes de reintentar o cambie del acceso sin clave al acceso autenticado.