Passer au contenu 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 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.

​
Ce que FIRE-1 peut faire :

  • 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.

​
Activation de l’agent FIRE-1

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.

​
Utiliser FIRE-1 avec le point de terminaison /scrape

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.

​
Utiliser FIRE-1 avec le point de terminaison d’extraction

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.

​
Découvrez FIRE-1 : navigation et interaction intelligentes

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.

​
Ce que FIRE-1 peut faire :

  • 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.

​
Comment activer FIRE-1

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.

​
Exemple d’utilisation avec le point de terminaison /scrape

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.

​
Points à prendre en compte

  • 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é.

​
Commencez à utiliser FIRE-1 dès aujourd’hui

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