Interagir avec une page scrapée
Exécutez du code ou un prompt d’IA dans la session de navigateur associée à une tâche de scraping.
code, soit prompt — pas les deux.
POST /v2/scrape/{jobId}/interact gère l’ensemble du cycle de vie :
- Si aucune session de navigateur n’existe encore pour cette tâche de scraping, Firecrawl en crée une dans le même état de page que le scrape d’origine.
- Lorsque
codeest fourni, Firecrawl l’exécute dans le sandbox du navigateur. Lorsquepromptest fourni, un agent IA automatise la tâche en langage naturel. - Les appels ultérieurs à
POST /interactsur le mêmejobIdréutilisent le même état actif du navigateur.
DELETE /v2/scrape/{jobId}/interact pour arrêter la session.
Paramètres de chemin
Corps de la requête
Réponse
Exemple de requête (Code)
Exemple de réponse (code)
Exemple de requête (Prompt)
Exemple de réponse (Prompt)
Codes d’erreur
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paramètres de chemin
L’ID de tâche de scrape
Corps
Code à exécuter dans le sandbox du navigateur lié au scrape
1 - 100000Langage du code à exécuter. Utilisez node pour JavaScript ou bash pour les commandes CLI de agent-browser.
python, node, bash Étiquette d’origine facultative utilisée pour la télémétrie d’exécution
Délai d’expiration de l’exécution, en secondes
1 <= x <= 300Réponse
Code exécuté avec succès
URL WebSocket brute du protocole Chrome DevTools (CDP) pour la session de navigateur. Utilisez-la pour vous connecter directement avec Playwright, Puppeteer ou tout autre client CDP.
Message d’erreur si le code a déclenché une exception
Code de sortie du processus exécuté
URL de la vue en direct interactive (les utilisateurs peuvent contrôler le navigateur)
Indique si le processus a été arrêté en raison d’un délai d’expiration
URL de la vue en direct en lecture seule pour la session de navigateur
Réponse finale de l’agent IA (présente uniquement lors de l’utilisation d’un prompt)
Sortie standard (alias de stdout)
Sortie d’erreur standard de l’exécution du code
Sortie standard de l’exécution du code

