メインコンテンツへスキップ
Vercel AI SDK v5 向け Firecrawl ツール。AI アプリケーション向けの Web スクレイピング、検索、クロール、データ抽出。

インストール

npm install firecrawl-aisdk ai @ai-sdk/openai
環境変数の設定:
FIRECRAWL_API_KEY=fc-your-key
OPENAI_API_KEY=sk-your-key
これらの例では OpenAI を使用していますが、Firecrawl のツールは Anthropic、Google、Mistral などを含む、すべての Vercel AI SDK プロバイダーで動作します。サポートされているプロバイダーの完全な一覧を参照してください。

クイックスタート

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { scrapeTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://firecrawl.dev をスクレイピングして、何をするものか要約してください',
  tools: { scrape: scrapeTool },
});

利用可能なツール

import {
  scrapeTool,         // 単一URLをスクレイピング
  searchTool,         // Web検索
  mapTool,            // サイト上のURLを検出
  crawlTool,          // 複数ページをクロール
  batchScrapeTool,    // 複数URLをスクレイピング
  extractTool,        // 構造化データを抽出
  pollTool,           // 非同期ジョブをポーリング
  statusTool,         // ジョブステータスを確認
  cancelTool,         // ジョブをキャンセル
} from 'firecrawl-aisdk';

使用例

スクレイピング

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { scrapeTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://firecrawl.dev をスクレイピングして、何をするものか要約してください',
  tools: { scrape: scrapeTool },
});

console.log(text);
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { searchTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'Firecrawlを検索し、見つけた内容を要約してください',
  tools: { search: searchTool },
});

console.log(text);

マップ

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { mapTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://docs.firecrawl.dev をマップして主要セクションをリスト化',
  tools: { map: mapTool },
});

console.log(text);

クロール

非同期オペレーション - ジョブステータスを確認するには pollTool を含めてください。
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { crawlTool, pollTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://docs.firecrawl.dev をクロール(3ページまで)して要約',
  tools: { crawl: crawlTool, poll: pollTool },
});

console.log(text);

バッチスクレイピング

非同期処理です。ジョブのステータスを確認するには pollTool を含めてください。
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { batchScrapeTool, pollTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://firecrawl.dev と https://docs.firecrawl.dev をスクレイピングして比較する',
  tools: { batchScrape: batchScrapeTool, poll: pollTool },
});

console.log(text);

抽出

非同期実行 — ジョブのステータスを確認するには pollTool を含めてください。
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { extractTool, pollTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'https://firecrawl.dev から主要機能を抽出',
  tools: { extract: extractTool, poll: pollTool },
});

console.log(text);

検索 + スクレイピング

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { searchTool, scrapeTool } from 'firecrawl-aisdk';

const { text } = await generateText({
  model: openai('gpt-5-mini'),
  prompt: 'Firecrawlを検索し、最上位の結果をスクレイピングして、それが何をするものか説明してください',
  tools: { search: searchTool, scrape: scrapeTool },
});

console.log(text);

ストリーム

import { streamText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { scrapeTool } from 'firecrawl-aisdk';

const result = streamText({
  model: openai('gpt-5-mini'),
  prompt: 'https://firecrawl.dev をスクレイピングして、何ができるか説明してください',
  tools: { scrape: scrapeTool },
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}