> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-27eiio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Herramientas de Firecrawl MCP
> Selecciona una herramienta de Firecrawl MCP y conoce su disponibilidad y funcionamiento.
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 la [configuración de MCP](/es/mcp-server) para seleccionar el acceso sin clave, OAuth o mediante clave de API. 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 de una URL conocida | `firecrawl_scrape` con formato JSON | Sabes qué página contiene los datos y quieres una salida que siga un prompt o esquema. |
| Buscar y extraer datos cuando se desconocen las fuentes | `firecrawl_agent` y `firecrawl_agent_status` | La tarea requiere descubrir una o más fuentes antes de producir resultados estructurados. |
| 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. |
| Investigar artículos y repositorios | `firecrawl_research_*` | Necesitas descubrir o leer artículos, buscar trabajos relacionados o repositorios públicos. |
| 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. |
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](/es/developer-guides/usage-guides/choosing-the-data-extractor) para ver la comparación completa.
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
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:
1. Llama a `firecrawl_parse` con `filePath` para recibir un comando de carga y `uploadRef`.
2. Ejecuta el comando de carga en la máquina que puede leer el archivo.
3. 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.
`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.
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.
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.
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ías de funcionalidades
Extrae contenido o campos estructurados de una URL.
Encuentra fuentes relevantes en la web, noticias, imágenes y fuentes para desarrolladores.
Recorre y extrae un sitio o una sección.
Convierte archivos en salidas listas para LLM.
Opera páginas dinámicas en una sesión de navegador activa.
Realiza investigaciones autónomas en múltiples fuentes.
Supervisa cambios en las páginas y recibe notificaciones.
## Solución de problemas
* **Falta una herramienta:** confirme el modo de conexión en [configuración de MCP](/es/mcp-server), 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](/es/rate-limits) actuales, espere el intervalo antes de reintentar o cambie del acceso sin clave al acceso autenticado.