firecrawl-interact

Par firecrawl · cli

Contrôlez et interagissez avec une session de navigateur en direct sur n'importe quelle page extraite — cliquez sur des boutons, remplissez des formulaires, naviguez dans des flux et extrayez des données à l'aide de prompts en langage naturel ou de code. À utiliser lorsque l'utilisateur a besoin d'interagir avec une page web au-delà du simple scraping : connexion à un site, soumission de formulaires, navigation dans la pagination, gestion du défilement infini, navigation dans des flux de paiement ou des assistants multi-étapes, ou lorsqu'un scrape classique a échoué parce que le contenu est conditionné à une interaction JavaScript. Également utile pour le scraping authentifié via des profils. Se déclenche sur « interact », « click », « fill out the form », « log in to », « sign in », « submit », « paginated », « next page », « infinite scroll », « interact with the page », « navigate to », « open a session » ou « scrape failed ».

npx skills add https://github.com/firecrawl/cli --skill firecrawl-interact

firecrawl interact

Interagissez avec des pages scrapées dans une session de navigateur en direct. Scrapez d'abord une page, puis utilisez des prompts en langage naturel ou du code pour cliquer, remplir des formulaires, naviguer et extraire des données.

Quand l'utiliser

  • Le contenu nécessite une interaction : clics, remplissage de formulaires, pagination, connexion
  • scrape a échoué parce que le contenu est derrière une interaction JavaScript
  • Vous devez naviguer dans un flux multi-étapes
  • Dernier recours dans le modèle d'escalade de workflow : search → scrape → map → crawl → interact
  • Ne jamais utiliser interact pour les recherches web — utilisez search à la place

Démarrage rapide

# 1. Scrapez une page (l'ID de scrape est sauvegardé automatiquement)
firecrawl scrape "<url>"

# 2. Interagissez avec la page en langage naturel
firecrawl interact --prompt "Click the login button"
firecrawl interact --prompt "Fill in the email field with test@example.com"
firecrawl interact --prompt "Extract the pricing table"

# 3. Ou utilisez du code pour un contrôle précis
firecrawl interact --code "agent-browser click @e5" --language bash
firecrawl interact --code "agent-browser snapshot -i" --language bash

# 4. Arrêtez la session une fois terminé
firecrawl interact stop

Options

Option Description
--prompt <text> Instruction en langage naturel (utilisez ceci OU --code)
--code <code> Code à exécuter dans la session de navigateur
--language <lang> Langage pour le code : bash, python, node
--timeout <seconds> Délai d'exécution (par défaut : 30, max : 300)
--scrape-id <id> Ciblez un scrape spécifique (par défaut : dernier scrape)
-o, --output <path> Chemin du fichier de sortie

Profils

Utilisez --profile sur le scrape pour persister l'état du navigateur (cookies, localStorage) entre les scrapes :

# Session 1 : Se connecter et sauvegarder l'état
firecrawl scrape "https://app.example.com/login" --profile my-app
firecrawl interact --prompt "Fill in email with user@example.com and click login"

# Session 2 : Revenir authentifié
firecrawl scrape "https://app.example.com/dashboard" --profile my-app
firecrawl interact --prompt "Extract the dashboard data"

Reconnexion en lecture seule (aucune écriture dans l'état du profil) :

firecrawl scrape "https://app.example.com" --profile my-app --no-save-changes

Conseils

  • Scrapez toujours d'abord — interact nécessite un ID de scrape d'un appel firecrawl scrape précédent
  • L'ID de scrape est sauvegardé automatiquement, donc vous n'avez pas besoin de --scrape-id pour les appels interact suivants
  • Utilisez firecrawl interact stop pour libérer les ressources une fois terminé
  • Pour du travail en parallèle, scrapez plusieurs pages et interagissez avec chacune en utilisant --scrape-id

Voir aussi

  • firecrawl-scrape — essayez d'abord scrape, escaladez vers interact seulement si nécessaire
  • firecrawl-search — pour les recherches web (n'utilisez jamais interact pour les recherches)
  • firecrawl-agent — extraction alimentée par IA (moins de contrôle manuel)

Skills similaires