> ## 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.

# Vercel Marketplace

> Installez Firecrawl depuis le Vercel Marketplace, associez-le à un projet et utilisez la variable FIRECRAWL_API_KEY injectée dans votre application Vercel.

Firecrawl est disponible sous forme d’[intégration native sur le Vercel Marketplace](https://vercel.com/marketplace/firecrawl). 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.

<div id="what-the-integration-does">
  ## Ce que fait l’intégration
</div>

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

<Note>
  Si vous avez déjà une clé API Firecrawl et souhaitez configurer Vercel manuellement, utilisez plutôt le [démarrage rapide Vercel Functions](/fr/quickstarts/vercel-functions).
</Note>

<div id="install-from-vercel">
  ## Installer depuis Vercel
</div>

1. Ouvrez la [page Firecrawl sur la Vercel Marketplace](https://vercel.com/marketplace/firecrawl).
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.

<div id="install-the-sdk">
  ## Installer le SDK
</div>

Dans votre projet Vercel, installez le Firecrawl Node SDK :

```bash theme={null}
npm install firecrawl
```

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.

<div id="scrape-a-page">
  ## Scraper une page
</div>

Créez un Route Handler dans `app/api/scrape/route.ts` :

```typescript theme={null}
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";

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 :

```bash theme={null}
curl -X POST https://your-project.vercel.app/api/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.firecrawl.dev"}'
```

<div id="search-the-web">
  ## Rechercher sur le web
</div>

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

```typescript theme={null}
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";

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);
}
```

<div id="interact-with-dynamic-pages">
  ## Interagir avec des pages dynamiques
</div>

Utilisez `interact` lorsque votre application doit cliquer, faire défiler la page ou remplir des formulaires avant d’extraire le contenu.

```typescript theme={null}
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";

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 });
}
```

<Note>
  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.
</Note>

<div id="use-firecrawl-with-the-vercel-ai-sdk">
  ## Utiliser Firecrawl avec le Vercel AI SDK
</div>

Si vous créez un agent avec le [Vercel AI SDK](/fr/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk), installez les outils de l’AI SDK Firecrawl :

```bash theme={null}
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.

<Note>
  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.
</Note>

```typescript theme={null}
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);
```

<div id="next-steps">
  ## Étapes suivantes
</div>

<CardGroup cols={2}>
  <Card title="démarrage rapide Vercel Functions" icon="bolt" href="/fr/quickstarts/vercel-functions">
    Utilisez Firecrawl dans Vercel Functions avec une configuration manuelle de l’environnement
  </Card>

  <Card title="Guide du Vercel AI SDK" icon="puzzle-piece" href="/fr/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk">
    Ajoutez les outils Firecrawl aux agents du Vercel AI SDK
  </Card>

  <Card title="Documentation Scrape" icon="file-lines" href="/fr/features/scrape">
    Convertissez des pages Web en Markdown, JSON, captures d’écran et bien plus encore
  </Card>

  <Card title="Documentation de recherche" icon="magnifying-glass" href="/fr/features/search">
    Recherchez sur le Web et obtenez le contenu des pages à partir des résultats
  </Card>
</CardGroup>