Pour les workflows d’agents, utilisez Interact. Interact est le parcours CLI/MCP pris en charge et peut être piloté avec des prompts ou du code après un scrape ; MCP permet aussi d’ouvrir directement depuis une URL.
| Surface | À utiliser pour | Point d’entrée | Surface agent |
|---|---|---|---|
| Browser Sandbox | Sessions de navigateur autonomes pour les utilisateurs de l’API et des SDKs qui ont besoin d’un bac à sable, d’une URL CDP, d’une vue en direct ou d’une gestion persistante du cycle de vie des sessions | POST /v2/interact | API et SDKs ; la commande CLI de navigateur masquée est héritée |
| Interact | Agir sur une page scrapée ; MCP peut aussi ouvrir directement depuis une URL via le mode URL firecrawl_interact | POST /v2/scrape/{scrapeId}/interact, CLI interact après scrape, ou MCP firecrawl_interact | Recommandé pour les workflows d’agents CLI/MCP |
firecrawl browser est héritée ; les workflows d’agents CLI et MCP doivent utiliser scrape + interact à la place.
Pour ajouter la prise en charge d’Interact à un agent de codage IA (Claude Code, Codex, Open Code, Cursor, etc.), installez la compétence Firecrawl :
Démarrage rapide
- Aucune installation de driver requise — Pas de binaire Chromium, pas de
playwright install, pas de problèmes de compatibilité de driver - Python, JavaScript & Bash — Envoyez du code via l’API, la CLI ou le SDK et récupérez les résultats. Les trois langages s’exécutent à distance dans la sandbox
- agent-browser — CLI préinstallée avec plus de 60 commandes. Les agents d’IA écrivent de simples commandes bash au lieu de code Playwright
- Playwright préinstallé — Playwright est déjà disponible dans la sandbox. Les agents peuvent écrire du code Playwright s’ils le préfèrent.
- Accès CDP — Connectez votre propre instance Playwright via WebSocket lorsque vous avez besoin d’un contrôle total
- Vue en direct — Suivez les sessions en temps réel via une URL de flux intégrable
- Vue en direct interactive — Permettez aux utilisateurs d’interagir directement avec le navigateur via un flux en direct interactif intégrable
Lancer une session
Response
Exécuter le code
stdout ; pour Node.js, la valeur de la dernière expression est également disponible dans result.
Response
Gestion des téléchargements de fichiers
execute :
Le système de fichiers du bac à sable est éphémère : les fichiers téléchargés sont perdus à la fin de la session. Pour les conserver, lisez leur contenu pendant la session et enregistrez-le dans votre propre espace de stockage. Les profils persistants conservent l’état du navigateur (cookies, localStorage), mais pas les fichiers sur le disque.
agent-browser (Mode Bash)
--cdp pour permettre à agent-browser de se connecter à votre session active.
Les exemples de CLI
firecrawl browser ci-dessous concernent les sessions Browser Sandbox héritées. Pour les workflows d’agents en CLI/MCP, privilégiez firecrawl interact ou l’outil MCP firecrawl_interact.Raccourci
browser. Le raccourci et execute envoient tous les deux des commandes à agent-browser automatiquement. Le raccourci se contente d’omettre execute et de lancer automatiquement une session si nécessaire :
CLI
execute. Les commandes sont envoyées automatiquement à agent-browser : vous n’avez pas besoin de saisir agent-browser ni d’utiliser --bash :
API & SDK
language: "bash" pour exécuter des commandes agent-browser via l’API ou les SDK :
Gestion des sessions
Sessions persistantes
profile, vous pouvez enregistrer et réutiliser l’état du navigateur entre les sessions. C’est utile pour rester connecté et conserver les préférences.
Pour enregistrer ou sélectionner un profil, utilisez le paramètre profile lors de la création d’une session.
| Paramètre | Valeur par défaut | Description |
|---|---|---|
name | — | Un nom pour le profil persistant. Les sessions portant le même nom partagent le stockage. |
saveChanges | true | Lorsque true, l’état du navigateur est enregistré dans le profil à la clôture. Définissez false pour charger les données existantes sans écrire — utile lorsque vous avez besoin de plusieurs lecteurs simultanés. |
Une seule session peut enregistrer dans un profil à la fois. Si une autre session enregistre déjà, vous recevrez une erreur
409. Vous pouvez quand même ouvrir le même profil avec saveChanges: false, ou réessayer plus tard.Lister les sessions
Response
Configuration du TTL
| Paramètre | Valeur par défaut | Description |
|---|---|---|
ttl | 600s (10 min) | Durée de vie maximale de la session (30-3600s) |
activityTtl | 300s (5 min) | Fermeture automatique après inactivité (10-3600s) |
Clore une session
Vue en direct
liveViewUrl dans la réponse, que vous pouvez intégrer pour observer le navigateur en temps réel. Pratique pour le débogage, les démonstrations ou la création d’interfaces utilisateur pilotées par le navigateur.
Response
Vue en direct interactive
interactiveLiveViewUrl. Contrairement à la vue en direct standard, qui est en lecture seule, la vue en direct interactive permet aux utilisateurs de cliquer, de saisir du texte et d’interagir avec la session de navigation directement via le flux intégré. C’est utile pour créer des interfaces de navigateur destinées aux utilisateurs finaux, pour le débogage collaboratif, ou pour tout scénario où la personne qui consulte la session doit contrôler le navigateur.
Connexion via CDP
execute et l’option --bash couvrent la plupart des cas d’utilisation, mais si vous avez besoin d’un contrôle complet en local, vous pouvez vous connecter directement.
Quand utiliser Browser
| Cas d’usage | Outil adapté |
|---|---|
| Extraire le contenu d’une URL connue | Scrape |
| Rechercher sur le Web et obtenir des résultats | Search |
| Naviguer dans la pagination, remplir des formulaires, cliquer au fil des parcours | Browser |
| Workflows multi-étapes avec interaction | Browser |
| Navigation en parallèle sur de nombreux sites | Browser (chaque session est isolée) |
Cas d’utilisation
- Veille concurrentielle - Parcourir les sites concurrents, naviguer dans les formulaires et filtres de recherche, extraire les tarifs et les fonctionnalités sous forme de données structurées
- Ingestion de base de connaissances - Naviguer dans les centres d’aide, la documentation et les portails d’assistance qui nécessitent des clics, de la pagination ou une authentification
- Études de marché - Lancer des sessions de navigation parallèles pour constituer des jeux de données à partir de sites d’offres d’emploi, d’annonces immobilières ou de bases de données juridiques
Tarification
Limites de débit
Référence de l’API
- Créer une session de navigateur
- Exécuter du code dans le navigateur
- Lister les sessions de navigateur
- Supprimer une session de navigateur
Vous avez des retours ou besoin d’aide ? Envoyez-nous un e-mail à help@firecrawl.com ou contactez-nous sur Discord.
Vous êtes un agent IA qui a besoin d’une API key Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour les instructions d’onboarding automatisé.

