Skip to main content
Firecrawl est disponible sous forme d’intégration native sur le Vercel Marketplace. Son installation configure Firecrawl pour votre projet Vercel et ajoute automatiquement FIRECRAWL_API_KEY aux variables d’environnement du projet. Utilisez ce guide si vous souhaitez que la facturation de Firecrawl, la configuration de la clé API et celle du projet se fassent via Vercel.

Ce que fait l’intégration

Lorsque vous installez Firecrawl depuis le Vercel Marketplace, Vercel connecte Firecrawl à un projet sélectionné et met la clé API à disposition sous forme de variable d’environnement.
  • Crée un compte Firecrawl et une clé API via le processus du Marketplace
  • Ajoute FIRECRAWL_API_KEY à l’environnement de votre projet Vercel
  • Maintient la facturation Firecrawl sur votre facture Vercel
  • Vous permet d’ouvrir Firecrawl depuis Vercel une fois l’intégration connectée
Si vous avez déjà une clé API Firecrawl et souhaitez configurer Vercel manuellement, utilisez plutôt le démarrage rapide Vercel Functions.

Installer depuis Vercel

  1. Ouvrez la page Firecrawl sur la Vercel Marketplace.
  2. Cliquez sur Connect Account.
  3. Choisissez l’offre Firecrawl que vous souhaitez utiliser.
  4. Sélectionnez le projet Vercel qui doit recevoir la variable d’environnement.
  5. Terminez l’installation.
Après l’installation, redéployez votre projet afin que les Vercel Functions et le code serveur du framework puissent lire la nouvelle variable d’environnement.

Installer le SDK

Dans votre projet Vercel, installez le Firecrawl Node SDK :
Vous n’avez pas besoin d’insérer une clé API dans votre code. Récupérez process.env.FIRECRAWL_API_KEY côté serveur.

Scraper une page

Créez un Route Handler dans app/api/scrape/route.ts :
Testez la route après le déploiement :

Rechercher sur le web

Utilisez search lorsque votre application a besoin de résultats de recherche web à jour ainsi que du contenu des pages :

Interagir avec des pages dynamiques

Utilisez interact lorsque votre application doit cliquer, faire défiler la page ou remplir des formulaires avant d’extraire le contenu.
Les interactions plus longues peuvent dépasser les délais d’expiration courts du serverless. Pour les workflows de production susceptibles de prendre plus de temps, exécutez le traitement dans un job en arrière-plan ou utilisez les API async de Firecrawl avec des webhooks.

Utiliser Firecrawl avec le Vercel AI SDK

Si vous créez un agent avec le Vercel AI SDK, installez les outils de l’AI SDK Firecrawl :
Transmettez ensuite les outils Firecrawl à votre modèle. La FIRECRAWL_API_KEY installée via Marketplace est récupérée depuis l’environnement.
L’exemple ci-dessous utilise le format de chaîne des modèles de Vercel AI Gateway. Configurez séparément votre fournisseur de modèles AI SDK ou vos identifiants Vercel AI Gateway.

Étapes suivantes

démarrage rapide Vercel Functions

Utilisez Firecrawl dans Vercel Functions avec une configuration manuelle de l’environnement

Guide du Vercel AI SDK

Ajoutez les outils Firecrawl aux agents du Vercel AI SDK

Documentation Scrape

Convertissez des pages Web en Markdown, JSON, captures d’écran et bien plus encore

Documentation de recherche

Recherchez sur le Web et obtenez le contenu des pages à partir des résultats