# NestJS (/pt-BR/quickstarts/nestjs)
Related: [Node.js](/pt-BR/quickstarts/nodejs.md), [Next.js](/pt-BR/quickstarts/nextjs.md), [Express](/pt-BR/quickstarts/express.md), [Fastify](/pt-BR/quickstarts/fastify.md), [Hono](/pt-BR/quickstarts/hono.md), [Bun](/pt-BR/quickstarts/bun.md)
## Pré-requisitos [#pré-requisitos]
* Projeto NestJS (`@nestjs/cli`)
* Uma chave de API do Firecrawl — [obtenha uma grátis](https://www.firecrawl.dev/app/api-keys)
## Instale o SDK [#instale-o-sdk]
```bash
npm install firecrawl
```
Adicione sua chave de API ao `.env`:
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Crie um serviço do Firecrawl [#crie-um-serviço-do-firecrawl]
Crie `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;
}
}
```
## Crie um controller [#crie-um-controller]
Crie `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);
}
}
```
## Registre o módulo [#registre-o-módulo]
Crie `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 {}
```
Importe `FirecrawlModule` no `AppModule`.
## Experimente [#experimente]
```bash
curl -X POST http://localhost:3000/firecrawl/search \
-H "Content-Type: application/json" \
-d '{"query": "firecrawl web scraping"}'
```
## Próximos passos [#próximos-passos]
Todas as opções de scraping, incluindo formatos, ações e proxies
Faça buscas na web e obtenha o conteúdo completo da página
Clique, preencha formulários e extraia conteúdo dinâmico
Referência completa do SDK, com rastreamento, map, extração em lote e muito mais