Mastra

将 Firecrawl 集成到 Mastra 工具中，让你的代理和工作流能够搜索并抓取实时网页数据。

​

前提条件

• Node.js 22.13+
• 一个 Firecrawl API 密钥——免费获取一个
• 来自受支持的 Mastra 模型提供商的 API 密钥
• 一个现有的 Mastra 项目——按照 Mastra 快速开始 进行创建

​

安装 SDK

npm install @mendable/firecrawl-js

​

设置 API 密钥

将 API 密钥添加到 .env 中：

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

​

构建 Firecrawl 工具

创建 src/mastra/tools/firecrawl.ts，将 search 和 抓取 暴露为 Mastra 工具：

import Firecrawl from "@mendable/firecrawl-js";
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 ?? "" };
  },
});

​

创建代理

创建 src/mastra/agents/web-agent.ts，并为其添加 Firecrawl 工具：

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

​

注册代理

在 src/mastra/index.ts 中向你的 Mastra 实例注册代理：

import { Mastra } from "@mastra/core";
import { webAgent } from "./agents/web-agent";

export const mastra = new Mastra({
  agents: { webAgent },
});

​

在 Studio 中测试

运行开发服务器，并打开 Mastra Studio：

mastra dev

打开 网页代理，尝试以下 prompt：

• “查找最新的 Firecrawl 更新日志，并总结最近一次发布的内容。”
• “搜索 Firecrawl 的定价，并提取各套餐档位。“

​

自托管 Firecrawl

如果你在本地运行 Firecrawl，请设置 FIRECRAWL_API_URL，并向客户端传入 apiUrl：

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

​

后续步骤

抓取文档

包含 formats、actions 和代理在内的所有抓取选项

搜索文档

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

代理文档

让代理全程驱动 Firecrawl

Node SDK 参考

完整的 SDK 参考，涵盖爬取、映射、批量抓取等功能