# Mastra (/es/quickstarts/mastra)
Related: [Node.js](/es/quickstarts/nodejs.md), [Next.js](/es/quickstarts/nextjs.md), [Express](/es/quickstarts/express.md), [NestJS](/es/quickstarts/nestjs.md), [Fastify](/es/quickstarts/fastify.md), [Hono](/es/quickstarts/hono.md)
## Requisitos previos [#requisitos-previos]
* Node.js 22.13+
* Una clave de API de Firecrawl — [obtén una gratis](https://www.firecrawl.dev/app/api-keys)
* Una clave de API de un [proveedor de modelos compatible con Mastra](https://mastra.ai/models)
* Un proyecto de Mastra existente — sigue el [inicio rápido de Mastra](https://mastra.ai/guides/getting-started/quickstart) para configurarlo
## Instala el SDK [#instala-el-sdk]
```bash
npm install firecrawl
```
## Configura tu clave de API [#configura-tu-clave-de-api]
Añade tu clave de API a `.env`:
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Crea las herramientas de Firecrawl [#crea-las-herramientas-de-firecrawl]
Crea `src/mastra/tools/firecrawl.ts` para exponer la búsqueda y el scraping como herramientas de Mastra:
```typescript
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 ?? "" };
},
});
```
## Crea el agente [#crea-el-agente]
Crea `src/mastra/agents/web-agent.ts` y añade las herramientas de Firecrawl:
```typescript
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 },
});
```
## Registrar el agente [#registrar-el-agente]
Registra el agente en tu instancia de Mastra, en `src/mastra/index.ts`:
```typescript
import { Mastra } from "@mastra/core";
import { webAgent } from "./agents/web-agent";
export const mastra = new Mastra({
agents: { webAgent },
});
```
## Pruebas en Studio [#pruebas-en-studio]
Inicia el servidor de desarrollo y abre [Mastra Studio](https://mastra.ai/docs/studio/overview):
```bash
mastra dev
```
Abre el **Agente web** y prueba prompts como:
* "Encuentra el registro de cambios más reciente de Firecrawl y resume el último lanzamiento."
* "Busca los precios de Firecrawl y extrae los niveles de sus planes."
## Firecrawl autogestionado [#firecrawl-autogestionado]
Si ejecutas Firecrawl en local, configura `FIRECRAWL_API_URL` y pasa `apiUrl` al cliente:
```typescript
const firecrawl = new Firecrawl({
apiKey: process.env.FIRECRAWL_API_KEY!,
apiUrl: process.env.FIRECRAWL_API_URL,
});
```
## Próximos pasos [#próximos-pasos]
Todas las opciones de scraping, incluidos los formatos, las acciones y los proxies
Buscar en la web y obtener el contenido completo de la página
Deja que un agente gestione Firecrawl de principio a fin
Referencia completa del SDK con rastreo, mapeo, extracción por lotes y más