Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

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): 
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.

​
Uso de FIRE-1 con el endpoint de extracción

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): 
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

Visualización del agente FIRE-1 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: 
"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: 
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: