Skip to content
Firecrawl Docs
Firecrawl Docs
Point de terminaison de l’Agent

FIRE-1 Agent (Bêta)

FIRE-1 est un agent d’IA qui permet une navigation et une interaction intelligentes avec les pages web

FIRE-1 est un agent d’IA qui renforce les capacités de scraping de Firecrawl grâce à une navigation et des interactions web intelligentes. Il gère la pagination, contrôle des actions du navigateur et navigue dans des structures de sites complexes pour permettre une extraction de données plus complète, au-delà des méthodes de scraping traditionnelles.

  • Naviguer automatiquement dans le contenu paginé.
  • Interagir avec des boutons, des liens, des champs de saisie et des éléments dynamiques.
  • Réaliser des tâches d’extraction avancées sur plusieurs pages.

Pour activer l’agent FIRE-1, vous devez inclure l’objet agent dans le corps de votre requête API pour le point de terminaison scrape ou extract.

L’objet agent comporte les propriétés suivantes :

  • model (string, optionnel) : Spécifie le modèle d’IA à utiliser. S’il n’est pas fourni, la valeur par défaut est FIRE-1. Actuellement, FIRE-1 est le seul modèle disponible.
  • prompt (string, requis pour le point de terminaison scrape) : Donne des instructions à l’agent IA, en décrivant le contenu à rechercher et la manière de naviguer sur le site (par exemple, comment gérer la pagination, quels boutons cliquer, etc.). Dans /extract, il utilisera l’invite fournie dans le paramètre prompt.

Vous pouvez utiliser l’agent FIRE-1 avec le point de terminaison /v1/scrape pour effectuer une navigation intelligente avant d’extraire le contenu final.

Exemple (cURL) :

curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer VOTRE_API_KEY' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "Parcourez les fiches produits en cliquant sur le bouton « Page suivante » jusqu’à ce qu’il soit grisé/désactivé. Récupérez le contenu de chaque page visitée."
      }
    }'

Dans cet exemple, l’agent FIRE-1 est chargé de parcourir la pagination des fiches produits avant d’effectuer le scraping final.

De même, vous pouvez utiliser l’agent FIRE-1 avec le point de terminaison /v1/extract pour des tâches d’extraction complexes nécessitant de naviguer sur plusieurs pages ou d’interagir avec des éléments.

Exemple (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"
      }
    }'

Ici, l’agent veille à ce que tous les commentaires soient chargés sur la page en interagissant avec le bouton “Charger plus de commentaires” avant de lancer le processus d’extraction à partir du schema et du prompt fournis. Remarque : L’agent FIRE-1 offre de puissantes capacités, mais peut consommer davantage de crédits en fonction de la complexité des instructions de navigation et du nombre de pages avec lesquelles il interagit.

Visualisation de l'agent FIRE-1

FIRE-1 apporte un nouveau niveau d’intelligence à Firecrawl en enrichissant vos tâches de scraping grâce à la navigation dans des structures de sites web complexes, à la gestion de la pagination, à l’interaction avec du contenu dynamique, et bien plus encore. Ce puissant agent IA garantit une extraction complète des données, au-delà des méthodes de scraping traditionnelles.

  • Parcourir automatiquement le contenu paginé.
  • Interagir avec des boutons, des liens et des éléments dynamiques.
  • Réaliser des extractions avancées sur plusieurs pages.

L’activation de FIRE-1 est simple. Il suffit d’inclure un objet agent dans votre requête API de scraping ou d’extraction :

"agent": {
  "model": "FIRE-1",
  "prompt": "Saisissez ici vos instructions de navigation détaillées."
}

Remarque : Le champ prompt est requis pour les requêtes de scraping et indique précisément à FIRE-1 comment interagir avec la page web.

Voici un exemple rapide utilisant FIRE-1 avec le point de terminaison /scrape pour parcourir des listes de produits page par page :

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."
    }
  }'

Dans ce scénario, FIRE-1 gère intelligemment la pagination et récupère l’ensemble des produits.

  • L’utilisation de FIRE-1 peut consommer plus de crédits selon la complexité de la tâche et le niveau d’interaction.
  • Assurez-vous que vos prompts indiquent clairement à FIRE-1 quoi faire afin d’optimiser les résultats et l’efficacité.

Découvrez dès aujourd’hui l’avenir du web scraping :

Was this page helpful?Suggest editsRaise issue