Mastra

npm install firecrawl

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

import { Firecrawl } from "firecrawl";import { createTool } from "@mastra/core/tools";import { z } from "zod";const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY! });export const firecrawlSearch = createTool({  id: "firecrawl-search",  description: "Search the web and return top results.",  inputSchema: z.object({ query: z.string().min(1) }),  outputSchema: z.object({    results: z.array(      z.object({        title: z.string().nullable(),        url: z.string(),      }),    ),  }),  execute: async ({ query }) => {    const results = await firecrawl.search(query, { limit: 3 });    return {      results: (results.web ?? []).map((item) => ({        title: item.title ?? null,        url: item.url,      })),    };  },});export const firecrawlScrape = createTool({  id: "firecrawl-scrape",  description: "Scrape a URL and return markdown content.",  inputSchema: z.object({ url: z.string().url() }),  outputSchema: z.object({ markdown: z.string() }),  execute: async ({ url }) => {    const result = await firecrawl.scrape(url, {      formats: ["markdown"],      onlyMainContent: true,    });    return { markdown: result.markdown ?? "" };  },});

import { Agent } from "@mastra/core/agent";import { firecrawlSearch, firecrawlScrape } from "../tools/firecrawl";export const webAgent = new Agent({  id: "web-agent",  name: "Web Agent",  instructions:    "Use Firecrawl tools to search and scrape web pages, then summarize the results.",  model: "openai/gpt-5.4",  tools: { firecrawlSearch, firecrawlScrape },});

import { Mastra } from "@mastra/core";import { webAgent } from "./agents/web-agent";export const mastra = new Mastra({  agents: { webAgent },});

mastra dev

const firecrawl = new Firecrawl({  apiKey: process.env.FIRECRAWL_API_KEY!,  apiUrl: process.env.FIRECRAWL_API_URL,});