> ## 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. # Interact après le scraping > Interagissez avec une page que vous avez récupérée à l’aide d’un prompt ou en exécutant du code. Scrapez une page pour obtenir des données propres, puis appelez `/interact` pour commencer à effectuer des actions sur cette page : cliquer sur des boutons, remplir des formulaires, extraire du contenu dynamique ou naviguer plus en profondeur. Décrivez simplement ce que vous voulez faire, ou écrivez du code si vous avez besoin d’un contrôle total. Décrivez l’action que vous souhaitez effectuer sur la page Interagissez en toute sécurité via l’exécution de code avec playwright, agent-browser Observez ou interagissez avec le browser en temps réel via un flux intégrable
## Comment ça fonctionne
1. **Scrape** une URL avec `POST /v2/scrape`. La réponse inclut un `scrapeId` dans `data.metadata.scrapeId`. Si vous souhaitez conserver l’état du navigateur, transmettez `profile` dans cette requête. 2. **Interact** en appelant `POST /v2/scrape/{scrapeId}/interact` avec un `prompt` ou du code `playwright`. Ne transmettez pas `profile` ici ; la session d’interaction hérite du profil de la tâche de scraping. 3. **Arrêtez** la session avec `DELETE /v2/scrape/{scrapeId}/interact` lorsque vous avez terminé. Pour les profils inscriptibles, les modifications sont enregistrées à l’arrêt de la session.
## Démarrage rapide
Scrapez une page, interagissez avec elle, puis arrêtez la session : ```python Python theme={null} from firecrawl import Firecrawl app = Firecrawl( # Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées : # 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 'firecrawl'; const app = new Firecrawl({ // Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées : // 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 # Aucune API key requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées : RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \ -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 "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 "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" ``` ```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 ``` ```json Response theme={null} { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "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 } ```
## Interagir par prompt
La manière la plus simple d’interagir avec une page. Décrivez ce que vous voulez en langage naturel, et l’agent cliquera, saisira du texte, fera défiler la page et extraira automatiquement les données. ```python Python theme={null} response = app.interact(scrape_id, prompt="What are the customer reviews saying about battery life?") print(response.output) ``` ```js Node theme={null} const response = await app.interact(scrapeId, { prompt: 'What are the customer reviews saying about battery life?', }); console.log(response.output); ``` ```bash cURL theme={null} # Aucune clé API requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées : curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "prompt": "What are the customer reviews saying about battery life?" }' ``` ```bash CLI theme={null} firecrawl interact "What are the customer reviews saying about battery life?" ``` La réponse inclut un champ `output` avec la réponse de l’agent : ```json Response theme={null} { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "output": "Customers are generally positive about battery life. Most reviewers report 8-10 hours of use on a single charge. A few noted it drains faster with heavy multitasking.", "stdout": "...", "result": "...", "stderr": "", "exitCode": 0, "killed": false } ```
### Gardez les prompts courts et ciblés
Les prompts sont plus efficaces lorsque chacun correspond à **une tâche unique et claire**. Au lieu de demander à l'agent d'exécuter un workflow complexe en plusieurs étapes en une seule fois, décomposez-le en appels `interact` distincts. Chaque appel réutilise la même session de navigateur, de sorte que l'état est conservé d'un appel à l'autre.
## Exécution de code
Pour un contrôle total, vous pouvez exécuter du code directement dans le sandbox du navigateur. La variable `page` (un objet Playwright Page) est disponible en Node.js et en Python. Le mode Bash inclut [agent-browser](https://github.com/vercel-labs/agent-browser) en préinstallation. Vous pouvez également prendre des captures d’écran pendant la session : utilisez `(await page.screenshot()).toString("base64")` en Node.js, `await page.screenshot(path="/tmp/screenshot.png")` en Python, ou `agent-browser screenshot` en Bash.
### Node.js (Playwright)
Le langage par défaut. Écrivez directement du code Playwright. `page` est déjà connectée au navigateur. ```python Python theme={null} response = app.interact(scrape_id, code=""" // Cliquer sur un bouton et attendre la navigation await page.click('#next-page'); await page.waitForLoadState('networkidle'); // Extraire le contenu de la nouvelle page const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); """) print(response.result) ``` ```js Node theme={null} const response = await app.interact(scrapeId, { code: ` // Cliquer sur un bouton et attendre la navigation await page.click('#next-page'); await page.waitForLoadState('networkidle'); // Extraire le contenu de la nouvelle page const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); `, }); console.log(response.result); ``` ```bash cURL theme={null} # Aucune clé API requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées : curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "code": "await page.click(\"#next-page\"); await page.waitForLoadState(\"networkidle\"); const title = await page.title(); JSON.stringify({ title });", "language": "node", "timeout": 30 }' ``` ```bash CLI theme={null} # Utilise le dernier scrape automatiquement firecrawl interact -c " await page.click('#next-page'); await page.waitForLoadState('networkidle'); const title = await page.title(); const content = await page.\$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); " # Ou passer un ID de scrape explicitement # firecrawl interact -c "await page.title()" ```
### Python
Définissez `language` sur `"python"` pour l’API Python de Playwright. ```python Python theme={null} response = app.interact( scrape_id, code=""" import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [] for item in items: text = await item.text_content() data.append(text.strip()) print(json.dumps(data)) """, language="python", ) print(response.stdout) ``` ```js Node theme={null} const response = await app.interact(scrapeId, { code: ` import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [] for item in items: text = await item.text_content() data.append(text.strip()) print(json.dumps(data)) `, language: 'python', }); console.log(response.stdout); ``` ```bash cURL theme={null} # Aucune clé API requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées : curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "code": "import json\nawait page.click(\"#load-more\")\nawait page.wait_for_load_state(\"networkidle\")\nitems = await page.query_selector_all(\".item\")\ndata = [await i.text_content() for i in items]\nprint(json.dumps(data))", "language": "python" }' ``` ```bash CLI theme={null} firecrawl interact --python -c " import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [await i.text_content() for i in items] print(json.dumps(data)) " ```
### Bash (agent-browser)
[agent-browser](https://github.com/vercel-labs/agent-browser) est une CLI préinstallée dans le sandbox avec plus de 60 commandes. Elle fournit un arbre d’accessibilité avec des références d’éléments (`@e1`, `@e2`, ...), ce qui est idéal pour l’automatisation pilotée par un LLM. ```python Python theme={null} # Prendre un instantané pour voir les éléments interactifs snapshot = app.interact( scrape_id, code="agent-browser snapshot -i", language="bash", ) print(snapshot.stdout) # Output : # [document] # @e1 [input type="text"] "Search..." # @e2 [button] "Search" # @e3 [link] "About" # Interagir avec les éléments via les @refs app.interact( scrape_id, code='agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language="bash", ) ``` ```js Node theme={null} // Prendre un instantané pour voir les éléments interactifs const snapshot = await app.interact(scrapeId, { code: 'agent-browser snapshot -i', language: 'bash', }); console.log(snapshot.stdout); // Output: // [document] // @e1 [input type="text"] "Search..." // @e2 [button] "Search" // @e3 [link] "About" // Interagir avec les éléments en utilisant les @refs await app.interact(scrapeId, { code: 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language: 'bash', }); ``` ```bash cURL theme={null} # Prendre un instantané pour voir les éléments interactifs # Aucune API key requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées : curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"code": "agent-browser snapshot -i", "language": "bash"}' # Interagir avec les éléments en utilisant les @refs curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"code": "agent-browser fill @e1 \"firecrawl\" && agent-browser click @e2", "language": "bash"}' ``` ```bash CLI theme={null} # Prendre un instantané pour voir les éléments interactifs firecrawl interact --bash -c "agent-browser snapshot -i" # Interagir avec les éléments en utilisant les @refs firecrawl interact --bash -c 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2' ``` Commandes courantes d’agent-browser : | Commande | Description | | ------------------------- | -------------------------------------------------------- | | `snapshot` | Arbre d’accessibilité complet avec références d’éléments | | `snapshot -i` | Éléments interactifs uniquement | | `click @e1` | Cliquer sur un élément par référence | | `fill @e1 "text"` | Effacer le champ et saisir du texte | | `type @e1 "text"` | Saisir sans effacer | | `press Enter` | Appuyer sur une touche du clavier | | `scroll down 500` | Faire défiler vers le bas de 500 pixels | | `get text @e1` | obtenir le contenu du texte | | `get url` | obtenir l’URL actuelle | | `wait @e1` | Attendre un élément | | `wait --load networkidle` | Attendre l’inactivité du réseau | | `find text "X" click` | Trouver un élément par son texte et cliquer | | `screenshot` | Prendre une capture d’écran de la page actuelle | | `eval "js code"` | Exécuter du JavaScript dans la page |
## Vue en direct
Chaque réponse Interact renvoie un `liveViewUrl` que vous pouvez intégrer pour voir le navigateur en temps réel. Utile pour le débogage, les démonstrations ou la création d’interfaces pilotées par le navigateur. ```json Response theme={null} { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "stdout": "", "result": "...", "exitCode": 0 } ``` ```html theme={null}