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. 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.
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.
- Ouvrez la page Firecrawl sur la Vercel Marketplace.
- Cliquez sur Connect Account.
- Choisissez l’offre Firecrawl que vous souhaitez utiliser.
- Sélectionnez le projet Vercel qui doit recevoir la variable d’environnement.
- 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.
Dans votre projet Vercel, installez le Firecrawl Node SDK :
npm install firecrawlVous n’avez pas besoin d’insérer une clé API dans votre code. Récupérez process.env.FIRECRAWL_API_KEY côté serveur.
Créez un Route Handler dans app/api/scrape/route.ts :
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 :
curl -X POST https://your-project.vercel.app/api/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://www.firecrawl.dev"}'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 "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);
}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 "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.
Si vous créez un agent avec le Vercel AI SDK, installez les outils de l’AI SDK Firecrawl :
npm install firecrawl-aisdk aiTransmettez 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);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