跳转到主要内容

前提条件

安装 SDK

npm install @mendable/firecrawl-js

环境变量

不要直接传递 apiKey,请改为设置 FIRECRAWL_API_KEY 环境变量:
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
const app = new Firecrawl();

进行网页搜索

import Firecrawl from '@mendable/firecrawl-js';

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);
}

抓取网页

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

console.log(result.markdown);
{
  "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
  "metadata": {
    "title": "Example Domain",
    "sourceURL": "https://example.com"
  }
}

与页面交互

使用 interact 控制实时浏览器会话——点击按钮、填写表单,并提取动态内容。
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);

下一步

抓取文档

包含所有 scrape 选项,包括 formats、actions 和代理

搜索文档

进行网页搜索并获取完整页面内容

交互文档

点击、填写表单并提取动态内容

Node SDK 参考文档

完整的 SDK 参考,涵盖爬取、map、batch scrape 等功能