# Fastify (/pt-BR/quickstarts/fastify)
Related: [Node.js](/pt-BR/quickstarts/nodejs.md), [Next.js](/pt-BR/quickstarts/nextjs.md), [Express](/pt-BR/quickstarts/express.md), [NestJS](/pt-BR/quickstarts/nestjs.md), [Hono](/pt-BR/quickstarts/hono.md), [Bun](/pt-BR/quickstarts/bun.md)
## Pré-requisitos [#pré-requisitos]
* Node.js 18+
* Uma chave de API do Firecrawl — [obtenha uma grátis](https://www.firecrawl.dev/app/api-keys)
## Configuração [#configuração]
```bash
npm install fastify firecrawl
```
Adicione sua chave de API ao arquivo `.env`:
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Fazer uma busca na web [#fazer-uma-busca-na-web]
```javascript
import Fastify from "fastify";
import { Firecrawl } from "firecrawl";
const fastify = Fastify({ logger: true });
const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });
fastify.post("/search", async (request) => {
const { query } = request.body;
return firecrawl.search(query, { limit: 5 });
});
fastify.listen({ port: 3000 });
```
## Fazer scraping de uma página [#fazer-scraping-de-uma-página]
```javascript
fastify.post("/scrape", async (request) => {
const { url } = request.body;
return firecrawl.scrape(url);
});
```
## Interagir com uma página [#interagir-com-uma-página]
Use o interact para controlar uma sessão ativa do navegador — clique em botões, preencha formulários e extraia conteúdo dinâmico.
```javascript
fastify.post("/interact", async (request) => {
const { url } = request.body;
const result = await firecrawl.scrape(url, { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;
await firecrawl.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
const response = await firecrawl.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
await firecrawl.stopInteraction(scrapeId);
return { output: response.output };
});
```
## Como plugin do Fastify [#como-plugin-do-fastify]
Encapsule o cliente em um plugin para reutilizá-lo em várias rotas:
```javascript
import fp from "fastify-plugin";
import { Firecrawl } from "firecrawl";
export default fp(async function firecrawlPlugin(fastify) {
const client = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });
fastify.decorate("firecrawl", client);
});
```
Registre o plugin e, em seguida, use `fastify.firecrawl` em qualquer rota:
```javascript
fastify.register(firecrawlPlugin);
fastify.post("/search", async function (request) {
const { query } = request.body;
return this.firecrawl.search(query, { limit: 5 });
});
```
## Teste [#teste]
```bash
curl -X POST http://localhost:3000/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 uma busca 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