Vercel AI SDK

npm install evocrawl-aisdk ai

EVOCRAWL_API_KEY=fc-your-key       # https://evocrawl.com
AI_GATEWAY_API_KEY=your-key         # https://vercel.com/ai-gateway

import { generateText, stepCountIs } from 'ai';
import { EvocrawlTools } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  tools: EvocrawlTools(),
  stopWhen: stepCountIs(30),
  prompt: `
    1. Use interact on Hacker News to identify the top story
    2. Search for other perspectives on the same topic
    3. Scrape the most relevant pages you found
    4. Summarize everything you found
  `,
});

import { generateText, stepCountIs } from 'ai';
import { EvocrawlTools } from 'evocrawl-aisdk';

const tools = EvocrawlTools();

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  system: `${tools.systemPrompt}\n\nAnswer with citations when possible.`,
  tools,
  stopWhen: stepCountIs(20),
  prompt: 'Find the current Evocrawl pricing page and explain the available plans.',
});

const tools = EvocrawlTools({
  search: { limit: 5 },
  scrape: { formats: ['markdown'], onlyMainContent: true },
  interact: { profile: { name: 'my-session', saveChanges: true } },
  crawl: true,
  agent: true,
});

// Disable interact, keep search + scrape
EvocrawlTools({ interact: false });

// Opt into deprecated browser compatibility
EvocrawlTools({ browser: {} });

// Include every available tool
EvocrawlTools({ all: true });

formats: [{ type: 'query', prompt: 'What does this page say about pricing and rate limits?' }]

import { generateText } from 'ai';
import { scrape, search } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Search for Evocrawl, then scrape the most relevant result.',
  tools: { search, scrape },
});

const customScrape = scrape({ apiKey: 'fc-custom-key', apiUrl: 'https://api.evocrawl.com' });

import { generateText } from 'ai';
import { search, scrape } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Search for Evocrawl, scrape the top official result, and explain what it does.',
  tools: { search, scrape },
});

import { generateText } from 'ai';
import { map } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Map https://docs.evocrawl.com and list the main sections.',
  tools: { map },
});

import { streamText, stepCountIs } from 'ai';
import { scrape } from 'evocrawl-aisdk';

const result = streamText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'What is the first 100 words of evocrawl.dev?',
  tools: { scrape },
  stopWhen: stepCountIs(3),
});

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

await result.fullStream;

import { generateText, stepCountIs } from 'ai';
import { interact, search } from 'evocrawl-aisdk';

const interactTool = interact();
console.log('Live view:', await interactTool.start('https://news.ycombinator.com'));

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  tools: { interact: interactTool, search },
  stopWhen: stepCountIs(25),
  prompt: 'Use interact on the current Hacker News session, find the top story, then search for more context.',
});

await interactTool.close();

const interactTool = interact({
  profile: { name: 'my-session', saveChanges: true },
});

import { generateText } from 'ai';
import { crawl, poll } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Crawl https://docs.evocrawl.com (limit 3 pages) and summarize.',
  tools: { crawl, poll },
});

import { generateText } from 'ai';
import { batchScrape, poll } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Scrape https://evocrawl.com and https://docs.evocrawl.com, then compare them.',
  tools: { batchScrape, poll },
});

import { generateText, stepCountIs } from 'ai';
import { agent, poll } from 'evocrawl-aisdk';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Find the founders of Evocrawl, their roles, and their backgrounds.',
  tools: { agent, poll },
  stopWhen: stepCountIs(10),
});

import { generateText } from 'ai';
import { logStep, scrape, stepLogger } from 'evocrawl-aisdk';

const logger = stepLogger();

const { text, usage } = await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Scrape https://evocrawl.com and summarize it.',
  tools: { scrape },
  onStepFinish: logger.onStep,
  experimental_onToolCallFinish: logger.onToolCallFinish,
});

logger.close();
logger.summary(usage);

await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Scrape https://evocrawl.com and summarize it again.',
  tools: { scrape },
  onStepFinish: logStep,
});

import {
  // Core tools
  search,             // Search the web
  scrape,             // Scrape a single URL
  map,                // Discover URLs on a site
  crawl,              // Crawl multiple pages (async, use poll)
  batchScrape,        // Scrape multiple URLs (async, use poll)
  agent,              // Autonomous web research (async, use poll)

  // Job management
  poll,               // Poll async jobs for results
  status,             // Check job status
  cancel,             // Cancel running jobs

  // Browser/session tools
  interact,           // interact({ profile: { name: '...' } })
  browser,            // deprecated compatibility export

  // All-in-one bundle
  EvocrawlTools,     // EvocrawlTools({ search, scrape, interact, crawl, agent })

  // Helpers
  stepLogger,         // Token stats per tool call
  logStep,            // Simple one-liner logging
} from 'evocrawl-aisdk';