Firecrawl CLI : ajouter extraction et recherche aux agents dans le terminal

À qui s’adresse ce guide

Ce guide s’adresse à celles et ceux qui ont besoin, depuis un terminal local, de recherche web, d’extraction de pages, d’interaction, de crawl de site, de sitemaps, ou d’exécuter directement des tâches d’agent. Officiellement, c’est à la fois une entrée en ligne de commande et une compétence d’agent qui peut s’installer dans les éditeurs de code détectés.

Si votre travail consiste à lire d’abord des pages publiques puis à décider s’il faut changer le code — plutôt que de construire vous-même un service d’extraction — ce chemin convient mieux. Les notes officielles mentionnent aussi la recherche dans des articles et des documents développeur. Ce n’est pas pour qui veut seulement quelques clics dans une interface graphique et ne peut pas exécuter de commandes terminal : le chemin recommandé installe un outil CLI, termine la connexion, et écrit les compétences dans les éditeurs détectés.

Le dépôt officiel est

https://github.com/firecrawl/cli

Suivez uniquement la formulation actuelle de cette page. Ne passez pas à un installeur ou à un répertoire de compétences qui n’y figure pas.

Premier essai en 3 minutes

Ne suivez que le chemin officiel recommandé.

Prérequis : le terminal peut exécuter npx, et un moyen d’accès Firecrawl est déjà prêt. Les notes officielles permettent aussi de définir la variable d’environnement FIRECRAWL_API_KEY ; init avec --browser passe par une connexion navigateur. Avant d’exécuter, confirmez que vous vous connecterez avec votre propre compte, et voyez que l’écriture par défaut vise tous les éditeurs de code détectés, pas un répertoire temporaire.

Emplacement d’installation : les compétences s’installent par défaut de façon globale dans les éditeurs détectés. Pour n’en viser qu’un, la forme officielle ajoute --agent <agent>.

Copiez et exécutez :

npx -y firecrawl-cli@latest init -y --browser

Signal de succès : la commande se termine normalement, cette machine peut appeler firecrawl, et les éditeurs détectés montrent une nouvelle compétence. Ne crawlez pas encore un site entier. Ensuite, faites une vérification réversible : exécutez firecrawl setup core. Les notes officielles indiquent que ce groupe fournit les primitives scrape, search, crawl et interact, plus des compétences d’index ; skills en est l’alias. Une fois la commande acceptée, posez à l’agent installé une demande en lecture seule, par exemple « Utilise Firecrawl pour chercher le titre d’un document public, montre seulement les résultats, n’écris pas de fichiers. » Voir les résultats signifie que la compétence a été trouvée.

Quand vous avez besoin de compétences d’intégration applicative qui parlent à l’API Firecrawl, exécutez alors firecrawl setup build. Quand vous avez besoin de recettes de bout en bout comme la génération de pistes ou la recherche approfondie, exécutez alors firecrawl setup workflows. La première fois, installez seulement core pour ne pas écrire toutes les recettes d’un coup.

Exemples d’usage

Exemple 1 : ajouter les primitives de recherche et d’extraction à l’agent actuel. L’action officielle est firecrawl setup core, qui installe les primitives scrape, search, crawl et interact ainsi que les compétences d’index. Cela convient si vous travaillez déjà dans un éditeur détecté et voulez que l’agent cherche ou extraie d’abord des pages publiques avant de décider de modifier le dépôt. Terminez d’abord le init ci-dessus, puis installez seulement core. En cas de succès, une conversation doit déclencher une recherche ou une extraction et montrer un résumé des résultats. Les documents officiels ne donnent pas de chemin de dossier de compétences ; n’inventez pas un répertoire qui n’apparaît jamais.

Exemple 2 : vous avez besoin de recettes toutes faites plutôt que de primitives isolées. L’action officielle est firecrawl setup workflows ; les documents citent la génération de pistes et la recherche approfondie. Cela convient une fois que core fonctionne et que vous voulez une recherche par recette. Confirmez le succès de init, puis exécutez cette commande ; pour n’installer que dans un éditeur, ajoutez --agent <agent>. Le succès est l’apparition de ce groupe de compétences dans l’éditeur cible. Les étapes internes des recettes ne sont pas détaillées ; le matériel existant confirme seulement que workflows est installé, et vous ne pouvez pas compléter des sous-étapes non écrites.

Limites

Le matériel existant s’arrête aux commandes terminal, à la connexion navigateur ou à FIRECRAWL_API_KEY, et aux trois groupes d’installation core, build et workflows. Il n’impose aucune langue obligatoire et ne transforme pas « éditeurs détectés » en liste exclusive ; n’inférez pas du périmètre d’installation par défaut que seuls quelques clients fonctionnent.

N’appliquez pas cet init npx à un environnement qui n’autorise que la copie manuelle de fichiers de compétences et n’a pas de ligne de commande générale. Le matériel ne donne non plus aucune adresse de marché secondaire ni secret d’exemple.

init et setup écrivent des compétences dans les éditeurs détectés et ont des effets de bord. Confirmez d’abord l’éditeur cible ; après l’exécution, vérifiez seulement si les compétences sont apparues — ne crawlez pas tout de suite un site non autorisé. Extraction, interaction et crawl atteignent des sites externes ; vérifiez d’abord avec une page publique que vous pouvez rouvrir.

FIRECRAWL_API_KEY est un nom de variable d’environnement, pas un secret d’exemple à coller dans le texte. N’inventez pas de sous-commandes, de noms de compétences ou de chemins d’installation absents. Pour plus de détail, suivez le dépôt officiel :

https://github.com/firecrawl/cli