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 la herramienta de mapeo:
url: URL base del sitio web que se va a mapearsearch: Término de búsqueda opcional para filtrar URLsitemap: Controla el uso del mapa del sitio: “include”, “skip” u “only”includeSubdomains: Indica si se deben incluir subdominios en el mapeolimit: Número máximo de URL que se devolveránignoreQueryParameters: Indica si se deben ignorar los parámetros de consulta durante el mapeo
3. Herramienta de búsqueda (firecrawl_search)
Opciones de la herramienta de búsqueda:
query: Cadena de consulta de búsqueda (obligatoria)limit: Número máximo de resultados que se devolveránlocation: Ubicación geográfica de los resultados de búsquedatbs: Filtro de búsqueda por tiempo (p. ej.,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 fuente donde buscar (web,images,news)scrapeOptions: Opciones de scraping para las páginas de resultados de búsquedaenterprise: Array de opciones empresariales (default,anon,zdr)
4. Herramienta de procesamiento (firecrawl_parse)
FIRECRAWL_API_URL, el MCP Server puede leer filePath directamente y envía los bytes del archivo a /v2/parse.
Cuando usas el MCP Server alojado remoto, este no puede leer archivos de tu máquina. En ese caso, firecrawl_parse utiliza una transferencia en dos pasos que también funciona en la URL remota sin clave:
- Llama a
firecrawl_parseconfilePath. La herramienta devuelve un comando de carga preconfigurado 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 Herramienta de procesamiento:
filePath: Ruta local del archivo que quieres procesar. Úsalo en la primera llamada.uploadRef: Referencia devuelta por la primera llamada al MCP alojado. Úsala en la segunda llamada, tras completar la carga.formats: Formatos de salida. El valor predeterminado esmarkdown.parsers: Controles del parser, como las opciones de procesamiento de PDF.contentType: Anulación opcional del tipo MIME del archivo.declaredSizeBytes: Indicación opcional del tamaño del archivo. El tamaño máximo de los archivos es de 50 MB.
firecrawl_scrape; detectará y procesará documentos desde URL.
5. Herramienta de rastreo (firecrawl_crawl)
6. Consultar el estado del rastreo (firecrawl_check_crawl_status)
7. Herramienta de extracción (firecrawl_extract)
Opciones de la herramienta de extracción:
urls: array de URL 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 extraer información de enlaces externosenableWebSearch: habilita la búsqueda web para obtener contexto adicionalincludeSubdomains: incluye subdominios en la extracción
8. Herramienta de agente (firecrawl_agent)
firecrawl_agent_status para comprobar cuándo ha finalizado y recuperar los resultados.
Opciones de herramienta de agente:
prompt: Descripción en lenguaje natural de los datos que quieres obtener (obligatorio, máximo 10.000 caracteres)urls: Array opcional de URL para que el agente se centre en páginas específicasschema: Esquema JSON opcional para obtener una salida estructurada
firecrawl_agent_status para sondear los resultados.
9. Consultar el estado del agente (firecrawl_agent_status)
Opciones de estado del agente:
id: ID del trabajo del agente devuelto porfirecrawl_agent(obligatorio)
processing: El agente sigue investigando — continúa consultandocompleted: La investigación ha finalizado — la respuesta incluye los datos extraídosfailed: Se produjo un error
10. Interactúa con una página (firecrawl_interact)
- Pasa
urlpara abrir e interactuar con una página nueva en una sola llamada MCP. - Pasa el
scrapeIdde una llamada anterior afirecrawl_scrapepara reutilizar la página ya cargada.
url y scrapeId a la vez. Proporciona prompt o code. scrapeOptions solo se puede usar en el modo url.
Ejemplo del modo URL:
Opciones de la herramienta Interact:
url: Página con la que interactuar; abre la sesión automáticamente. Usa este parámetro oscrapeId.scrapeId: ID de trabajo de scraping de una llamada anterior afirecrawl_scrape. Usa este parámetro ourl.prompt: Instrucción en lenguaje natural que describe la acción que se debe realizar. Proporcionapromptocode.code: Código que se ejecutará en la sesión del navegador. Proporcionacodeoprompt.language:bash,pythononode(opcional; el valor predeterminado esnode; solo se usa concode).timeout: Tiempo máximo de ejecución en segundos, de 1 a 300 (opcional; el valor predeterminado es 30).scrapeOptions: Controles de scraping opcionales que solo se usan 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
- El estado y el progreso de las operaciones
- Métricas de rendimiento
- Supervisión del uso de créditos
- Seguimiento de los límites de tasa
- Condiciones de error
Manejo de errores
- Reintentos automáticos ante errores transitorios
- Manejo de límites de tasa con backoff
- Mensajes de error detallados
- Advertencias sobre el uso de créditos
- Resiliencia de red

