> ## 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.
# Node.js
> Comece a usar o Firecrawl com Node.js. Faça scraping, realize buscas e interaja com dados da web usando o SDK oficial.
## Pré-requisitos
* Node.js 18+
* Uma chave da API do Firecrawl — [obtenha uma grátis](https://www.firecrawl.dev/app/api-keys)
## Instalar o SDK
```bash theme={null}
npm install firecrawl
```
## Variável de ambiente
Em vez de passar `apiKey` diretamente, defina a variável de ambiente `FIRECRAWL_API_KEY`:
```bash theme={null}
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```javascript theme={null}
const app = new Firecrawl();
```
## Fazer uma busca na web
```javascript theme={null}
import { Firecrawl } from 'firecrawl';
const app = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });
const results = await app.search("firecrawl web scraping", { limit: 5 });
for (const result of results.web) {
console.log(result.title, result.url);
}
```
## Fazer scraping de uma página
```javascript theme={null}
const result = await app.scrape("https://example.com");
console.log(result.markdown);
```
```json theme={null}
{
"markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
"metadata": {
"title": "Example Domain",
"sourceURL": "https://example.com"
}
}
```
## Interaja com uma página
Use o recurso de interagir para controlar uma sessão ativa no navegador — clique em botões, preencha formulários e extraia conteúdo dinâmico.
```javascript theme={null}
const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;
await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
console.log(response.output);
await app.stopInteraction(scrapeId);
```
## 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