> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-mog-monitoring-docs.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Recherchez sur le web, scrapez n’importe quelle page et interagissez avec elle — le tout via une seule API.

<Note>
  **Pour les agents IA :** Ajoutez `.md` à n’importe quelle URL de la documentation pour obtenir la version markdown, par ex.
  [introduction.md](/fr/introduction.md).
</Note>

<div id="get-started">
  ## Pour commencer
</div>

<CardGroup cols={2}>
  <Card title="Obtenez votre clé d'API" icon="key" href="https://www.firecrawl.dev/app/api-keys">
    Inscrivez-vous et obtenez votre clé d'API pour commencer à utiliser Firecrawl
  </Card>

  <Card title="Essayez-le dans le Playground" icon="play" href="https://www.firecrawl.dev/playground">
    Testez l'API instantanément, sans écrire la moindre ligne de code
  </Card>
</CardGroup>

<div id="use-firecrawl-with-ai-agents-recommended">
  ### Utiliser Firecrawl avec des agent IA (recommandé)
</div>

Les skills Firecrawl sont le moyen le plus rapide pour les agents de découvrir et d’utiliser Firecrawl. Sans eux, votre agent ne saura pas que Firecrawl est disponible.

```bash theme={null}
npx -y firecrawl-cli@latest init --all --browser
```

<Note>
  Redémarrez votre agent après avoir installé les skills. Consultez [Skills + CLI](/fr/sdks/cli)
  pour la configuration complète.
</Note>

Ou utilisez le [MCP Server](/fr/mcp-server) pour connecter Firecrawl directement à Claude, Cursor, Windsurf, VS Code et à d'autres outils d'IA.

***

<div id="what-can-firecrawl-do">
  ## Que peut faire Firecrawl ?
</div>

<CardGroup cols={3}>
  <Card title="Recherche" icon="magnifying-glass" href="#search">
    Rechercher sur le web et obtenir le contenu complet des pages à partir des résultats
  </Card>

  <Card title="Scrape" icon="file-lines" href="#scrape">
    Extraire le contenu de n’importe quelle URL en markdown, HTML ou JSON structuré
  </Card>

  <Card title="Interact" icon="hand-pointer" href="#interact">
    Continuer à travailler avec n’importe quelle page scrapée — cliquer, remplir des formulaires, extraire du contenu dynamique
  </Card>
</CardGroup>

<div id="why-firecrawl">
  ### Pourquoi Firecrawl ?
</div>

* **Sortie prête pour les LLM** : Markdown propre, JSON structuré, captures d’écran, et plus encore.
* **Gère les aspects complexes** : proxys, protections anti-bot, rendu JavaScript et contenu dynamique.
* **Fiable** : conçu pour la production, avec une haute disponibilité et des résultats constants.
* **Rapide** : des résultats en quelques secondes, optimisé pour un débit élevé.
* **MCP Server** : connectez Firecrawl à n’importe quel outil d’IA via le [Model Context Protocol](/fr/mcp-server).

***

<div id="search">
  ## Recherche
</div>

Effectuez une recherche sur le web et obtenez le contenu complet des pages à partir des résultats en un seul appel. Consultez la [documentation de la fonctionnalité de recherche](/fr/features/search) pour toutes les options.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

  results = firecrawl.search(
      query="firecrawl",
      limit=3,
  )
  print(results)
  ```

  ```js Node.js theme={null}
  import Firecrawl from '@mendable/firecrawl-js';

  const firecrawl = new Firecrawl({ apiKey: "fc-VOTRE-CLÉ-API" });

  const results = await firecrawl.search('firecrawl', {
    limit: 3,
    scrapeOptions: { formats: ['markdown'] }
  });
  console.log(results);
  ```

  ```bash cURL theme={null}
  curl -s -X POST "https://api.firecrawl.dev/v2/search" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "firecrawl",
      "limit": 3
    }'
  ```

  ```bash CLI theme={null}
  # Rechercher sur le web
  firecrawl search "firecrawl web scraping" --limit 5 --pretty
  ```
</CodeGroup>

<Accordion title="Réponse">
  Les SDK renverront directement l’objet `data`. cURL renverra la charge utile complète.

  ```json JSON theme={null}
  {
    "success": true,
    "data": {
      "web": [
        {
          "url": "https://www.firecrawl.dev/",
          "title": "Firecrawl - L'API de données web pour l'IA",
          "description": "L'API d'exploration, de scraping et de recherche pour l'IA. Conçue pour passer à l'échelle. Firecrawl met l'ensemble du web à la portée des agents et développeurs d'IA.",
          "position": 1
        },
        {
          "url": "https://github.com/firecrawl/firecrawl",
          "title": "mendableai/firecrawl : Transformez des sites entiers en contenus prêts pour les LLM… - GitHub",
          "description": "Firecrawl est un service d'API qui prend une URL, l'explore et la convertit en Markdown propre ou en données structurées.",
          "position": 2
        },
        ...
      ],
      "images": [
        {
          "title": "Guide de démarrage rapide | Firecrawl",
          "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",
          "imageWidth": 5814,
          "imageHeight": 1200,
          "url": "https://docs.firecrawl.dev/",
          "position": 1
        },
        ...
      ],
      "news": [
        {
          "title": "La startup de Y Combinator Firecrawl est prête à payer 1 M$ pour embaucher trois agents IA comme employés",
          "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",
          "snippet": "Elle a désormais publié trois nouvelles annonces sur le job board de YC pour « agents IA uniquement » et a réservé un budget total de 1 million de dollars pour y parvenir.",
          "date": "il y a 3 mois",
          "position": 1
        },
        ...
      ]
    }
  }
  ```
</Accordion>

<div id="scrape">
  ## Scrape
</div>

Extrayez n’importe quelle URL et obtenez son contenu en markdown, HTML ou d’autres formats. Consultez la [documentation de la fonctionnalité Scrape](/fr/features/scrape) pour toutes les options.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

  # Extraire le contenu d’un site :
  doc = firecrawl.scrape("https://firecrawl.dev", formats=["markdown", "html"])
  print(doc)
  ```

  ```js Node theme={null}
  import Firecrawl from '@mendable/firecrawl-js';

  const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

  // Récupérer le contenu d’un site :
  const doc = await firecrawl.scrape('https://firecrawl.dev', { formats: ['markdown', 'html'] });
  console.log(doc);
  ```

  ```bash cURL theme={null}
  curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://firecrawl.dev",
      "formats": ["markdown", "html"]
    }'
  ```

  ```bash CLI theme={null}
  # Scrape a URL and get markdown
  firecrawl https://firecrawl.dev

  # Avec plusieurs formats (renvoie du JSON)
  firecrawl https://firecrawl.dev --format markdown,html,links --pretty
  ```
</CodeGroup>

<Accordion title="Réponse">
  Les SDK vont renvoyer directement l’objet data. cURL renverra la charge utile exactement comme indiqué ci-dessous.

  ```json theme={null}
  {
    "success": true,
    "data" : {
      "markdown": "Launch Week I est là ! [Découvrez notre sortie du Jour 2 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 2 mois offerts...",
      "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
      "metadata": {
        "title": "Accueil - Firecrawl",
        "description": "Firecrawl explore et convertit n'importe quel site web en markdown propre.",
        "language": "en",
        "keywords": "Firecrawl,Markdown,Données,Mendable,Langchain",
        "robots": "follow, index",
        "ogTitle": "Firecrawl",
        "ogDescription": "Transformez n'importe quel site web en données prêtes pour les LLM.",
        "ogUrl": "https://www.firecrawl.dev/",
        "ogImage": "https://www.firecrawl.dev/og.png?123",
        "ogLocaleAlternate": [],
        "ogSiteName": "Firecrawl",
        "sourceURL": "https://firecrawl.dev",
        "statusCode": 200,
        "contentType": "text/html"
      }
    }
  }
  ```
</Accordion>

<div id="interact">
  ## Interact
</div>

Scrapez une page, puis continuez à travailler avec elle — cliquez sur des boutons, remplissez des formulaires, extrayez du contenu dynamique ou naviguez plus en profondeur. Décrivez ce que vous voulez en anglais courant ou écrivez du code pour un contrôle total. Consultez la [documentation de la fonctionnalité Interact](/fr/features/interact) pour toutes les options.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  app = Firecrawl(api_key="fc-YOUR-API-KEY")

  # 1. Scraper la page d'accueil d'Amazon
  result = app.scrape("https://www.amazon.com", formats=["markdown"])
  scrape_id = result.metadata.scrape_id

  # 2. Interagir — rechercher un produit et obtenir son prix
  app.interact(scrape_id, prompt="Search for iPhone 16 Pro Max")
  response = app.interact(scrape_id, prompt="Click on the first result and tell me the price")
  print(response.output)

  # 3. Arrêter la session
  app.stop_interaction(scrape_id)
  ```

  ```js Node theme={null}
  import Firecrawl from '@mendable/firecrawl-js';

  const app = new Firecrawl({ apiKey: 'fc-YOUR-API-KEY' });

  // 1. Scraper la page d'accueil d'Amazon
  const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
  const scrapeId = result.metadata?.scrapeId;

  // 2. Interagir — rechercher un produit et obtenir son prix
  await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
  const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
  console.log(response.output);

  // 3. Arrêter la session
  await app.stopInteraction(scrapeId);
  ```

  ```bash cURL theme={null}
  # 1. Scraper la page d'accueil d'Amazon
  RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}')

  SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId')

  # 2. Interagir — rechercher un produit et obtenir son prix
  curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Search for iPhone 16 Pro Max"}'

  curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Click on the first result and tell me the price"}'

  # 3. Arrêter la session
  curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY"
  ```

  ```bash CLI theme={null}
  # 1. Scrape la page d'accueil d'Amazon (l'ID de scrape est sauvegardé automatiquement)
  firecrawl scrape https://www.amazon.com

  # 2. Interagir — rechercher un produit et obtenir son prix
  firecrawl interact "Search for iPhone 16 Pro Max"
  firecrawl interact "Click on the first result and tell me the price"

  # 3. Arrêter la session
  firecrawl interact stop
  ```
</CodeGroup>

<Accordion title="Réponse">
  ```json Response theme={null}
  {
    "success": true,
    "liveViewUrl": "https://liveview.firecrawl.dev/...",
    "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
    "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",
    "exitCode": 0,
    "killed": false
  }
  ```
</Accordion>

***

<div id="more-capabilities">
  ## Plus de fonctionnalités
</div>

<CardGroup cols={4}>
  <Card title="Agent" icon="robot" href="/fr/features/agent">
    Collecter automatiquement des données web grâce à l’IA
  </Card>

  <Card title="Browser Sandbox" icon="browser" href="/fr/features/browser">
    Gérer des sessions de navigateur pour des workflows interactifs
  </Card>

  <Card title="Map" icon="map" href="/fr/features/map">
    Découvrir toutes les URL d’un site web
  </Card>

  <Card title="Crawl" icon="spider-web" href="/fr/features/crawl">
    Collecter récursivement le contenu de sites entiers
  </Card>
</CardGroup>

***

<div id="resources">
  ## Ressources
</div>

<CardGroup cols={2}>
  <Card title="Référence de l’API" icon="code" href="/fr/api-reference/v2-introduction">
    Documentation complète de l’API avec des exemples interactifs
  </Card>

  <Card title="SDKs" icon="boxes-stacked" href="/fr/sdks/overview">
    SDKs Python, Node.js, CLI et communautaires
  </Card>

  <Card title="Open Source" icon="github" href="/fr/contributing/open-source-or-cloud">
    Hébergez Firecrawl vous-même ou contribuez au projet
  </Card>

  <Card title="Intégrations" icon="puzzle-piece" href="/fr/developer-guides/llm-sdks-and-frameworks/openai">
    LangChain, LlamaIndex, OpenAI et plus encore
  </Card>
</CardGroup>
