> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Classe FirecrawlBrowser

La classe `FirecrawlBrowser` fournit une automatisation de navigateur fondée sur le [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser). Elle provisionne des sessions de navigateur distantes au moyen de l’API Firecrawl et s’y connecte par le Chrome DevTools Protocol (CDP).

`FirecrawlBrowser` étend [`AgentBrowser`](https://mastra.zisheng.pro/fr/reference/browser/agent-browser) et expose le même ensemble de Tools déterministes. Utilisez-le lorsque vous souhaitez des sessions de navigateur hébergées plutôt qu’une installation locale de Chromium. Pour l’automatisation locale, consultez [`AgentBrowser`](https://mastra.zisheng.pro/fr/reference/browser/agent-browser). Pour les interactions en langage naturel assistées par l’IA, consultez [`StagehandBrowser`](https://mastra.zisheng.pro/fr/reference/browser/stagehand-browser).

## Exemple d’utilisation

```typescript
import { Agent } from '@mastra/core/agent'
import { FirecrawlBrowser } from '@mastra/browser-firecrawl'

const browser = new FirecrawlBrowser({
  apiKey: process.env.FIRECRAWL_API_KEY,
  firecrawl: {
    ttl: 600,
  },
})

export const browserAgent = new Agent({
  id: 'browser-agent',
  name: 'Browser Agent',
  instructions: `You can browse the web. Use browser_snapshot to see the page structure,
then interact with elements using their refs (e.g., @e5).`,
  model: 'openai/gpt-5.6-sol',
  browser,
})
```

## Paramètres du constructeur

`FirecrawlBrowser` accepte tous les [paramètres du constructeur d’`AgentBrowser`](https://mastra.zisheng.pro/fr/reference/browser/agent-browser), ainsi que les paramètres suivants :

**apiKey** (`string`): Clé d’API Firecrawl. Utilise par défaut la variable d’environnement FIRECRAWL\_API\_KEY. Le constructeur génère une erreur si aucune des deux n’est définie.

**apiUrl** (`string`): URL de base d’une API Firecrawl auto-hébergée.

**firecrawl** (`FirecrawlBrowserSessionOptions`): Options de session transmises à l’API Firecrawl browser() lors de la création de sessions Sandbox.

**firecrawl.ttl** (`number`): Durée de vie maximale de la session, en secondes.

**firecrawl.activityTtl** (`number`): Délai d’inactivité, en secondes, avant que le Sandbox ne recycle la session.

**firecrawl.streamWebView** (`boolean`): Lorsque la valeur est true, Firecrawl peut diffuser les frames WebView de la session distante.

**firecrawl.profile** (`{ name: string; saveChanges?: boolean }`): Profil de Sandbox Firecrawl nommé. Définissez saveChanges: true pour conserver les cookies et l’état de connexion à la fin de la session ; le simple fait de nommer un profil n’enregistre pas les modifications. Ce profil est distinct de l’option profile de niveau supérieur d’AgentBrowser, qui correspond au chemin d’un répertoire local de données utilisateur Playwright.

**firecrawl.integration** (`string`): Libellé d’intégration destiné aux analyses et au routage de Firecrawl.

**firecrawl.origin** (`string`): Indication d’origine de la session de navigateur Firecrawl.

## Cycle de vie des sessions

Le provisionnement des sessions dépend de l’option `scope` héritée d’`AgentBrowser` :

- `'thread'` (par défaut) : chaque fil de discussion dispose de sa propre session de Sandbox Firecrawl, créée lors de la première utilisation et supprimée lorsque la session de navigateur du fil est détruite.
- `'shared'` : une session de Sandbox Firecrawl est créée au lancement du navigateur et partagée entre tous les fils de discussion. La session est supprimée à la fermeture du navigateur.

Dans les deux cas, `FirecrawlBrowser` supprime la session Firecrawl distante lorsque le navigateur se ferme, y compris si la création de la session ou la connexion échoue en cours de route.

## Tools

`FirecrawlBrowser` fournit le même ensemble de Tools qu’`AgentBrowser`, notamment `browser_goto`, `browser_snapshot`, `browser_click`, `browser_type` et `browser_screenshot`. Consultez la [référence des Tools d’`AgentBrowser`](https://mastra.zisheng.pro/fr/reference/browser/agent-browser) pour obtenir la liste complète et les paramètres des Tools.

## Voir aussi

- [Documentation de Firecrawl](https://mastra.zisheng.pro/fr/docs/browser/firecrawl)
- [Référence d’`AgentBrowser`](https://mastra.zisheng.pro/fr/reference/browser/agent-browser)
- [Présentation de Browser](https://mastra.zisheng.pro/fr/docs/browser/overview)