> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-fix-js-response-syntax-highlighting.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# FIRE-1 (Agente) (Beta)
> FIRE-1 es un agente de IA que permite la navegación e interacción inteligentes con páginas web
FIRE-1 es un agente de IA que potencia las capacidades de scraping de Firecrawl mediante navegación e interacción web inteligentes. Puede gestionar la paginación, controlar acciones del navegador y recorrer estructuras web complejas para permitir una extracción de datos completa más allá de los métodos tradicionales de scraping.
### Qué puede hacer FIRE-1:
* Navegar automáticamente por contenido paginado.
* Interactuar con botones, enlaces, campos y elementos dinámicos.
* Realizar tareas avanzadas de extracción en múltiples páginas.
## Habilitar FIRE-1 (Agente)
Para habilitar el agente FIRE-1, debes incluir el objeto `agent` en la carga de tu solicitud a la API para el punto de conexión `scrape` o `extract`.
El objeto `agent` tiene las siguientes propiedades:
* `model` (string, opcional): Especifica el modelo de IA a utilizar. Si no se especifica, el valor predeterminado es `FIRE-1`. Actualmente, `FIRE-1` es el único modelo disponible.
* `prompt` (string, requerido para el punto de conexión `scrape`): Proporciona instrucciones para el agente de IA, indicando qué contenido buscar y cómo navegar por el sitio web (por ejemplo, cómo manejar la paginación, qué botones hacer clic, etc.). En `/extract` usará el prompt indicado en el parámetro `prompt`.
### Uso de FIRE-1 con el punto de conexión /scrape
Puedes usar el agente FIRE-1 con el punto de conexión `/v1/scrape` para realizar navegación inteligente antes de extraer el contenido final.
**Ejemplo (cURL):**
```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/scrape \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TU_CLAVE_API' \
-d '{
"url": "https://example.com/products?page=1",
"formats": ["markdown"],
"agent": {
"model": "FIRE-1",
"prompt": "Navega por las listas de productos haciendo clic en el botón «Siguiente página» hasta que esté desactivado. Extrae el contenido de cada página visitada."
}
}'
```
En este ejemplo, se indica al FIRE-1 (Agente) que avance por las páginas de productos antes de realizar la extracción final.
Del mismo modo, puedes aprovechar el agente FIRE-1 con el endpoint `/v1/extract` para tareas complejas de extracción que requieren navegar por varias páginas o interactuar con elementos.
**Ejemplo (cURL):**
```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/extract \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"urls": ["https://example-forum.com/topic/123"],
"prompt": "Extract all user comments from this forum thread.",
"schema": {
"type": "object",
"properties": {
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {"type": "string"},
"comment_text": {"type": "string"}
},
"required": ["author", "comment_text"]
}
}
},
"required": ["comments"]
},
"agent": {
"model": "FIRE-1"
}
}'
```
Aquí, el agente se asegura de que se carguen todos los comentarios de la página al interactuar con el botón "Cargar más comentarios" antes de iniciar el proceso de extracción, en función del esquema y el prompt proporcionados.
**Nota:** El agente FIRE-1 ofrece capacidades potentes, pero puede consumir más créditos según la complejidad de las instrucciones de navegación y la cantidad de páginas con las que interactúe.
### Conoce FIRE-1: navegación e interacción inteligentes
FIRE-1 aporta un nuevo nivel de inteligencia a Firecrawl, mejorando tus tareas de scraping al navegar por estructuras complejas de sitios web, gestionar la paginación, interactuar con contenido dinámico y mucho más. Este potente agente de IA garantiza una extracción de datos integral que va más allá de los métodos tradicionales de scraping.
### Qué puede hacer FIRE-1:
* Navegar automáticamente por contenido paginado.
* Interactuar con botones, enlaces y elementos dinámicos.
* Realizar tareas de extracción sofisticadas en múltiples páginas.
## Cómo habilitar FIRE-1
Activar FIRE-1 es sencillo. Solo tienes que incluir un objeto `agent` en tu solicitud a la API de scrape o extract:
```json theme={null}
"agent": {
"model": "FIRE-1",
"prompt": "Aquí van tus instrucciones de navegación detalladas."
}
```
*Nota:* El campo `prompt` es obligatorio en las solicitudes de scraping y le indica a FIRE-1 con precisión cómo interactuar con la página web.
## Ejemplo de uso con punto de conexión /scrape
Aquí tienes un ejemplo rápido de uso de FIRE-1 con el punto de conexión /scrape para paginar listados de productos:
```bash theme={null}
curl -X POST https://api.firecrawl.dev/v1/scrape \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"url": "https://example.com/products?page=1",
"formats": ["markdown"],
"agent": {
"model": "FIRE-1",
"prompt": "Navigate through the product listings by clicking the \'Next Page\' button until disabled. Scrape each page."
}
}'
```
En este escenario, FIRE-1 gestiona de forma inteligente la paginación y recopila todos los productos.
## Consideraciones
* Utilizar FIRE-1 puede consumir más créditos en función de la complejidad de la tarea y de la profundidad de la interacción.
* Asegúrate de que tus prompts orienten claramente a FIRE-1 para optimizar los resultados y la eficiencia.
## Comienza a usar FIRE-1 hoy
Descubre hoy el futuro del web scraping:
* **Prueba FIRE-1:** Integra navegación inteligente en tus flujos de scraping y extracción.
* **Explora la documentación:** Obtén más información en nuestra [documentación completa](https://docs.firecrawl.dev/agents/fire-1).
* **¿Necesitas ayuda?** Únete a nuestra [comunidad en Discord](https://discord.gg/S7Enyh9Abh) o escribe a [help@firecrawl.com](mailto:help@firecrawl.com).
**¿Listo para aprovechar el scraping con IA?** [Regístrate en Firecrawl](https://firecrawl.dev/signup) y comienza con FIRE-1 hoy.