> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Bun
> Use Firecrawl com Bun para criar servidores rápidos de scraping e busca na web.
## Pré-requisitos
* Bun 1.0+
* Uma chave de API do Firecrawl — [obtenha uma grátis](https://www.firecrawl.dev/app/api-keys)
## Instalar o SDK
```bash theme={null}
bun add firecrawl
```
Adicione sua chave de API ao `.env`:
```bash theme={null}
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Faça uma busca na web
Bun tem um servidor HTTP integrado. Crie `index.ts`:
```typescript theme={null}
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });
Bun.serve({
port: 3000,
async fetch(req) {
const url = new URL(req.url);
if (req.method === "POST" && url.pathname === "/search") {
const { query } = await req.json();
const results = await firecrawl.search(query, { limit: 5 });
return Response.json(results);
}
return new Response("Not found", { status: 404 });
},
});
console.log("Server running on port 3000");
```
Execute:
```bash theme={null}
bun run index.ts
```
## Fazer scraping de uma página
Adicione uma rota `/scrape` ao mesmo servidor:
```typescript theme={null}
if (req.method === "POST" && url.pathname === "/scrape") {
const { url: targetUrl } = await req.json();
const result = await firecrawl.scrape(targetUrl);
return Response.json(result);
}
```
## Interaja com uma página
Use o interact para controlar uma sessão do navegador em tempo real — clique em botões, preencha formulários e extraia conteúdo dinâmico.
```typescript theme={null}
if (req.method === "POST" && url.pathname === "/interact") {
const { url: targetUrl } = await req.json();
const result = await firecrawl.scrape(targetUrl, { 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 Response.json({ output: response.output });
}
```
## Uso em um script
Use o Firecrawl em um script Bun independente:
```typescript theme={null}
import { Firecrawl } from "firecrawl";
const app = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });
const results = await app.search("firecrawl web scraping", { limit: 5 });
console.log(results);
```
```bash theme={null}
bun run search.ts
```
## 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