Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

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 : 
npm install @mendable/firecrawl-js
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 : 
import { NextResponse } from "next/server";
import Firecrawl from "@mendable/firecrawl-js";

const firecrawl = new Firecrawl({
  apiKey: process.env.FIRECRAWL_API_KEY,
});

export async function POST(request: Request) {
  const { url } = await request.json();
  const result = await firecrawl.scrape(url, {
    formats: ["markdown"],
  });

  return NextResponse.json(result);
}
Testez la route après le déploiement : 
curl -X POST https://your-project.vercel.app/api/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.firecrawl.dev"}'

​
Rechercher sur le web

Utilisez search lorsque votre application a besoin de résultats de recherche web à jour ainsi que du contenu des pages : 
import { NextResponse } from "next/server";
import Firecrawl from "@mendable/firecrawl-js";

const firecrawl = new Firecrawl({
  apiKey: process.env.FIRECRAWL_API_KEY,
});

export async function POST(request: Request) {
  const { query } = await request.json();
  const results = await firecrawl.search(query, {
    limit: 5,
    scrapeOptions: {
      formats: ["markdown"],
    },
  });

  return NextResponse.json(results);
}

​
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. 
import { NextResponse } from "next/server";
import Firecrawl from "@mendable/firecrawl-js";

const firecrawl = new Firecrawl({
  apiKey: process.env.FIRECRAWL_API_KEY,
});

export async function POST() {
  const result = await firecrawl.scrape("https://news.ycombinator.com", {
    formats: ["markdown"],
  });
  const scrapeId = result.metadata?.scrapeId;

  if (!scrapeId) {
    return NextResponse.json(
      { error: "No interactive scrape session was created" },
      { status: 500 }
    );
  }

  const response = await firecrawl.interact(scrapeId, {
    prompt: "Open the first story and summarize the page.",
  });

  await firecrawl.stopInteraction(scrapeId);

  return NextResponse.json({ output: response.output });
}
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 : 
npm install firecrawl-aisdk ai
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.
import { generateText, stepCountIs } from "ai";
import { FirecrawlTools } from "firecrawl-aisdk";

const { text } = await generateText({
  model: "anthropic/claude-sonnet-4-5",
  tools: FirecrawlTools(),
  stopWhen: stepCountIs(20),
  prompt: "Search for recent Vercel AI SDK examples, scrape the best sources, and summarize them.",
});

console.log(text);

​
É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