firecrawl/skills

agent firecrawl

Extraction autonome pilotée par IA. L'agent navigue sur les sites et extrait des données structurées (prend 2 à 5 minutes).

Avant de lancer une extraction autonome pour des enregistrements ou des listes structurées, vérifiez avec firecrawl search alexandria '<données requises>' s'il existe un workflow ou un fournisseur de données prêt à l'emploi. Inspectez un contrat correspondant avec firecrawl list <fournisseur> <capacité> --pretty et exécutez-le avec firecrawl scrape --alexandria <fournisseur>/<capacité> --options '<JSON d\'entrée>' s'il couvre la tâche. Utilisez exactement le fournisseur, la capacité et les champs d'entrée de ce contrat. Continuez avec l'agent lorsqu'aucun outil approprié n'existe ou que la tâche nécessite une navigation autonome.

Démarrage rapide

# Extraire des données structurées
firecrawl agent "extraire tous les niveaux de tarification" --wait --json -o .firecrawl/pricing.json

# Avec un schéma JSON pour une sortie structurée
firecrawl agent "extraire les produits" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json

# Se concentrer sur des pages spécifiques
firecrawl agent "obtenir la liste des fonctionnalités" --urls "<url>" --wait --json -o .firecrawl/features.json

Exécutez firecrawl agent --help pour la liste complète des options.

Terminé lorsque : le fichier de sortie contient un JSON valide répondant à la demande — ou qu'un ID de tâche a été intentionnellement retourné pour une interrogation ultérieure.

Fournisseurs Alexandria

Une exécution utilise les fournisseurs de données Alexandria connectés uniquement lorsqu'elle commence avec un indicateur Alexandria : --alexandria, --toolkits <slugs> (jusqu'à 5), --max-calls <n>, --require-approval, ou --on-terms-required skip|ask. Les suivis sur ce fil conservent ces paramètres.

firecrawl agent "trouver le responsable des ventes chez <entreprise>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json

Avec --require-approval (nécessite --mode chat), une exécution peut se terminer par un pendingApproval au lieu d'effectuer un appel payant. Demandez à l'utilisateur, puis répondez-lui sur le même fil avec firecrawl agent "<invite de suivi>" --thread <threadId> --mode chat --approve <approvalId> (ou --decline <approvalId>). Une approbation terms ne se poursuit qu'une fois qu'un administrateur de l'organisation a accepté les conditions du fournisseur dans le tableau de bord Firecrawl ; donnez à l'utilisateur https://www.firecrawl.dev/app/settings?tab=data-sources, et utilisez firecrawl alexandria terms show <fournisseur> s'il souhaite d'abord consulter les conditions. Approuver ne les accepte pas.

IDs de tâche

Omettre --wait renvoie un ID de tâche. Un argument positionnel UUID est automatiquement détecté comme une vérification de statut :

# Vérifier une fois (équivalent à ajouter --status)
firecrawl agent "<job-id>"

# Attendre la fin d'une tâche existante, avec interrogation toutes les 10 secondes pendant 5 minutes maximum
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300

# Annuler une tâche active
firecrawl agent "<job-id>" --cancel

Conseils

• Utilisez --wait pour des résultats en ligne ; omettez-le uniquement lorsque vous souhaitez un ID de tâche à interroger ultérieurement (voir IDs de tâche).
• Utilisez --schema pour une sortie prévisible et structurée — sinon l'agent renvoie des données libres.
• Les exécutions de l'agent consomment plus de crédits que les simples extractions. Utilisez --max-credits pour limiter les dépenses.
• Pour une extraction simple sur une seule page, préférez scrape — c'est plus rapide et moins cher.

Voir aussi

• firecrawl-scrape — extraction simple d'une seule page
• firecrawl-interact — scrape + interaction pour une manipulation manuelle de la page (plus de contrôle)
• firecrawl-crawl — extraction en masse sans IA
• firecrawl-build-scrape — intégration d'une extraction structurée dans une application au lieu de l'exécuter ici

Retour d'expérience sur une session Alexandria

Pour signaler le résultat d'une session Alexandria ou un écart entre fournisseur et capacité, utilisez firecrawl alexandria feedback --rating good|partial|bad --url <site> --requested-functionality '<ce qui était nécessaire>' --objective '<l'objectif sous-jacent de la tâche>' --rationale '<ce qui s'est passé>' --json. Utilisez les résultats observés dans la justification. Aucun ID de tâche n'est nécessaire ; envoyez-le dans les 20 minutes suivant votre dernière recherche, découverte ou exécution Alexandria, sinon il sera rejeté. Chaque soumission rembourse 1 crédit, jusqu'à 10 par site et 100 par équipe chaque jour UTC. Les tableaux JSON optionnels --provider-feedback et --capability-feedback décrivent des écarts spécifiques ; inspectez firecrawl alexandria feedback --help pour leurs champs. Utilisez le problème de capacité missing_capability lorsqu'un fournisseur existe mais manque de la capacité nécessaire, et new_capability_request (avec requestedFunctionality) pour en demander une.