Node.js - Firecrawl Docs

Pré-requisitos#

Node.js 22+
Uma chave da API do Firecrawl — obtenha uma grátis

Instalar o SDK#

npm install firecrawl

Variável de ambiente#

Em vez de passar apiKey diretamente, defina a variável de ambiente FIRECRAWL_API_KEY:

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY

const app = new Firecrawl();

Fazer uma busca na web#

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#

const result = await app.scrape("https://example.com");console.log(result.markdown);

Exemplo de resposta

{  "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.

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#

Documentação de Scraping

Todas as opções de scraping, incluindo formatos, ações e proxies

Documentação de Busca

Faça uma busca na web e obtenha o conteúdo completo da página

Documentação para interagir

Clique, preencha formulários e extraia conteúdo dinâmico

Referência do SDK de Node

Referência completa do SDK com rastreamento, map, extração em lote e muito mais