# Vercel Marketplace (/fr/quickstarts/vercel-marketplace)
Related: [Node.js](/fr/quickstarts/nodejs.md), [Next.js](/fr/quickstarts/nextjs.md), [Express](/fr/quickstarts/express.md), [NestJS](/fr/quickstarts/nestjs.md), [Fastify](/fr/quickstarts/fastify.md), [Hono](/fr/quickstarts/hono.md)
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.
## Ce que fait l’intégration [#ce-que-fait-linté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](/fr/quickstarts/vercel-functions).
## Installer depuis Vercel [#installer-depuis-vercel]
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.
## Installer le SDK [#installer-le-sdk]
Dans votre projet Vercel, installez le Firecrawl Node SDK :
```bash
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.
## Scraper une page [#scraper-une-page]
Créez un Route Handler dans `app/api/scrape/route.ts` :
```typescript
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
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 [#rechercher-sur-le-web]
Utilisez `search` lorsque votre application a besoin de résultats de recherche web à jour ainsi que du contenu des pages :
```typescript
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);
}
```
## Interagir avec des pages dynamiques [#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.
```typescript
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 });
}
```
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 [#utiliser-firecrawl-avec-le-vercel-ai-sdk]
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
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.
```typescript
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 [#étapes-suivantes]
Utilisez Firecrawl dans Vercel Functions avec une configuration manuelle de l’environnement
Ajoutez les outils Firecrawl aux agents du Vercel AI SDK
Convertissez des pages Web en Markdown, JSON, captures d’écran et bien plus encore
Recherchez sur le Web et obtenez le contenu des pages à partir des résultats