# Vercel Marketplace (/es/quickstarts/vercel-marketplace)
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)
Firecrawl está disponible como una [integración nativa de Vercel Marketplace](https://vercel.com/marketplace/firecrawl). Al instalarla, se aprovisiona Firecrawl para tu proyecto de Vercel y se añade automáticamente `FIRECRAWL_API_KEY` a las variables de entorno del proyecto.
Usa esta guía si quieres que la facturación de Firecrawl, la configuración de la clave de API y la configuración del proyecto se gestionen a través de Vercel.
## Qué hace la integración [#qué-hace-la-integración]
Cuando instalas Firecrawl desde Vercel Marketplace, Vercel conecta Firecrawl a un proyecto seleccionado y pone la clave de API a disposición como variable de entorno.
* Crea una cuenta de Firecrawl y una clave de API durante el proceso del Marketplace
* Añade `FIRECRAWL_API_KEY` al entorno de tu proyecto de Vercel
* Mantiene la facturación de Firecrawl en tu factura de Vercel
* Te permite abrir Firecrawl desde Vercel una vez conectada la integración
Si ya tienes una clave de API de Firecrawl y quieres configurar Vercel manualmente, usa en su lugar el [inicio rápido de Función de Vercel](/es/quickstarts/vercel-functions).
## Instalar desde Vercel [#instalar-desde-vercel]
1. Abre la [página de Firecrawl en Vercel Marketplace](https://vercel.com/marketplace/firecrawl).
2. Haz clic en **Conectar cuenta**.
3. Selecciona el plan de Firecrawl que quieras usar.
4. Selecciona el proyecto de Vercel que debe recibir la variable de entorno.
5. Completa el flujo de instalación.
Después de la instalación, vuelve a desplegar tu proyecto para que las Funciones de Vercel y el código del servidor del framework puedan leer la nueva variable de entorno.
## Instala el SDK [#instala-el-sdk]
En tu proyecto de Vercel, instala el SDK de Firecrawl para Node.js:
```bash
npm install firecrawl
```
No necesitas pegar una clave de API en tu código. Lee `process.env.FIRECRAWL_API_KEY` en el servidor.
## Hacer scraping de una página [#hacer-scraping-de-una-página]
Crea un Route Handler en `app/api/scrape/route.ts`:
```typescript
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: process.env.FIRECRAWL_API_KEY,
});
export async function POST(request: Request) {
const { url } = await request.json();
const result = await firecrawl.scrape(url, {
formats: ["markdown"],
});
return NextResponse.json(result);
}
```
Prueba la ruta tras el despliegue:
```bash
curl -X POST https://your-project.vercel.app/api/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://www.firecrawl.dev"}'
```
## Buscar en la web [#buscar-en-la-web]
Usa `search` cuando tu app necesite resultados web actualizados además del contenido de la página:
```typescript
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: process.env.FIRECRAWL_API_KEY,
});
export async function POST(request: Request) {
const { query } = await request.json();
const results = await firecrawl.search(query, {
limit: 5,
scrapeOptions: {
formats: ["markdown"],
},
});
return NextResponse.json(results);
}
```
## Interactúa con páginas dinámicas [#interactúa-con-páginas-dinámicas]
Usa `interact` cuando tu aplicación necesite hacer clic, desplazarse o rellenar formularios antes de extraer contenido.
```typescript
import { NextResponse } from "next/server";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: process.env.FIRECRAWL_API_KEY,
});
export async function POST() {
const result = await firecrawl.scrape("https://news.ycombinator.com", {
formats: ["markdown"],
});
const scrapeId = result.metadata?.scrapeId;
if (!scrapeId) {
return NextResponse.json(
{ error: "No interactive scrape session was created" },
{ status: 500 }
);
}
const response = await firecrawl.interact(scrapeId, {
prompt: "Open the first story and summarize the page.",
});
await firecrawl.stopInteraction(scrapeId);
return NextResponse.json({ output: response.output });
}
```
Las interacciones más largas pueden superar los tiempos de espera cortos de los entornos serverless. Para flujos de trabajo de producción que puedan tardar más, ejecuta el trabajo en segundo plano o usa las API async de Firecrawl con webhooks.
## Usa Firecrawl con el Vercel AI SDK [#usa-firecrawl-con-el-vercel-ai-sdk]
Si estás desarrollando un agente con el [Vercel AI SDK](/es/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk), instala las herramientas del SDK de IA de Firecrawl:
```bash
npm install firecrawl-aisdk ai
```
Luego, pasa las herramientas de Firecrawl a tu modelo. La `FIRECRAWL_API_KEY` instalada desde Marketplace se lee del entorno.
El ejemplo de abajo usa el formato de cadena del modelo de Vercel AI Gateway. Configura por separado tu proveedor de modelos de AI SDK o las credenciales de AI Gateway.
```typescript
import { generateText, stepCountIs } from "ai";
import { FirecrawlTools } from "firecrawl-aisdk";
const { text } = await generateText({
model: "anthropic/claude-sonnet-4-5",
tools: FirecrawlTools(),
stopWhen: stepCountIs(20),
prompt: "Search for recent Vercel AI SDK examples, scrape the best sources, and summarize them.",
});
console.log(text);
```
## Próximos pasos [#próximos-pasos]
Usa Firecrawl en Función de Vercel con configuración manual del entorno
Añade herramientas de Firecrawl a los agentes de Vercel AI SDK
Convierte páginas web en Markdown, JSON, capturas de pantalla y más
Busca en la web y obtén el contenido de las páginas a partir de los resultados