# NestJS (/fr/quickstarts/nestjs)
Related: [Node.js](/fr/quickstarts/nodejs.md), [Next.js](/fr/quickstarts/nextjs.md), [Express](/fr/quickstarts/express.md), [Fastify](/fr/quickstarts/fastify.md), [Hono](/fr/quickstarts/hono.md), [Bun](/fr/quickstarts/bun.md)
## Prérequis [#prérequis]
* Un projet NestJS (`@nestjs/cli`)
* Une clé API Firecrawl — [obtenez-en une gratuitement](https://www.firecrawl.dev/app/api-keys)
## Installer le SDK [#installer-le-sdk]
```bash
npm install firecrawl
```
Ajoutez votre clé API à `.env` :
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Créer un service Firecrawl [#créer-un-service-firecrawl]
Créez `src/firecrawl/firecrawl.service.ts`:
```typescript
import { Injectable } from "@nestjs/common";
import { Firecrawl } from "firecrawl";
@Injectable()
export class FirecrawlService {
private readonly client: Firecrawl;
constructor() {
this.client = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });
}
async search(query: string, limit = 5) {
return this.client.search(query, { limit });
}
async scrape(url: string) {
return this.client.scrape(url);
}
async interact(url: string, prompts: string[]) {
const result = await this.client.scrape(url, { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;
const responses = [];
for (const prompt of prompts) {
const response = await this.client.interact(scrapeId, { prompt });
responses.push(response);
}
await this.client.stopInteraction(scrapeId);
return responses;
}
}
```
## Créer un contrôleur [#créer-un-contrôleur]
Créez `src/firecrawl/firecrawl.controller.ts`:
```typescript
import { Body, Controller, Post } from "@nestjs/common";
import { FirecrawlService } from "./firecrawl.service";
@Controller("firecrawl")
export class FirecrawlController {
constructor(private readonly firecrawlService: FirecrawlService) {}
@Post("search")
async search(@Body("query") query: string) {
return this.firecrawlService.search(query);
}
@Post("scrape")
async scrape(@Body("url") url: string) {
return this.firecrawlService.scrape(url);
}
@Post("interact")
async interact(@Body("url") url: string, @Body("prompts") prompts: string[]) {
return this.firecrawlService.interact(url, prompts);
}
}
```
## Enregistrez le module [#enregistrez-le-module]
Créez `src/firecrawl/firecrawl.module.ts` :
```typescript
import { Module } from "@nestjs/common";
import { FirecrawlService } from "./firecrawl.service";
import { FirecrawlController } from "./firecrawl.controller";
@Module({
providers: [FirecrawlService],
controllers: [FirecrawlController],
exports: [FirecrawlService],
})
export class FirecrawlModule {}
```
Importez `FirecrawlModule` dans votre `AppModule`.
## Essayez-le [#essayez-le]
```bash
curl -X POST http://localhost:3000/firecrawl/search \
-H "Content-Type: application/json" \
-d '{"query": "firecrawl web scraping"}'
```
## Étapes suivantes [#étapes-suivantes]
Toutes les options de scrape, y compris les formats, les actions et les proxies
Rechercher sur le web et obtenir le contenu complet des pages
Cliquer, remplir des formulaires et extraire du contenu dynamique
Référence complète du SDK avec crawl, cartographie, extraction par lot, etc.