> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace da Vercel

> Instale o Firecrawl pelo Marketplace da Vercel, vincule-o a um projeto e use a `FIRECRAWL_API_KEY` injetada no seu app na Vercel.

O Firecrawl está disponível como uma [integração nativa no Marketplace da Vercel](https://vercel.com/marketplace/firecrawl). Ao instalá-lo, o Firecrawl é provisionado para o seu projeto na Vercel, e a variável `FIRECRAWL_API_KEY` é adicionada automaticamente às variáveis de ambiente do projeto.

Use este guia quando quiser que a cobrança do Firecrawl, a configuração da chave de API e a configuração do projeto sejam feitas pela Vercel.

<div id="what-the-integration-does">
  ## O que a integração faz
</div>

Quando você instala o Firecrawl pelo Marketplace da Vercel, a Vercel conecta o Firecrawl ao projeto selecionado e disponibiliza a chave de API como variável de ambiente.

* Cria uma conta do Firecrawl e uma chave de API pelo fluxo do Marketplace
* Adiciona `FIRECRAWL_API_KEY` às variáveis de ambiente do seu projeto na Vercel
* Mantém a cobrança do Firecrawl na sua fatura da Vercel
* Permite abrir o Firecrawl na Vercel depois que a integração é conectada

<Note>
  Se você já tiver uma chave de API do Firecrawl e quiser configurar a Vercel manualmente, use o [guia de início rápido do Vercel Functions](/pt-BR/quickstarts/vercel-functions).
</Note>

<div id="install-from-vercel">
  ## Instalar pela Vercel
</div>

1. Abra a [página do Firecrawl no Marketplace da Vercel](https://vercel.com/marketplace/firecrawl).
2. Clique em **Connect Account**.
3. Escolha o plano do Firecrawl que deseja usar.
4. Selecione o projeto da Vercel que deve receber a variável de ambiente.
5. Conclua o processo de instalação.

Após a instalação, faça um novo deploy do seu projeto para que as Vercel Functions e o código de servidor do framework possam ler a nova variável de ambiente.

<div id="install-the-sdk">
  ## Instale o SDK
</div>

No seu projeto da Vercel, instale o SDK de Node da Firecrawl:

```bash theme={null}
npm install firecrawl
```

Você não precisa colar uma chave de API no seu código. Leia `process.env.FIRECRAWL_API_KEY` do lado do servidor.

<div id="scrape-a-page">
  ## Fazer scraping de uma página
</div>

Crie um route handler em `app/api/scrape/route.ts`:

```typescript theme={null}
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);
}
```

Teste a rota após o deploy:

```bash theme={null}
curl -X POST https://your-project.vercel.app/api/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.firecrawl.dev"}'
```

<div id="search-the-web">
  ## Faça uma busca na web
</div>

Use `search` quando seu app precisar de resultados atualizados da web e do conteúdo das páginas:

```typescript theme={null}
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);
}
```

<div id="interact-with-dynamic-pages">
  ## Interaja com páginas dinâmicas
</div>

Use `interact` quando seu app precisar clicar, rolar a página ou preencher formulários antes de extrair conteúdo.

```typescript theme={null}
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 });
}
```

<Note>
  Interações mais longas podem exceder os tempos limite curtos em ambientes serverless. Para fluxos de trabalho de produção que possam levar mais tempo, execute a tarefa em um job em segundo plano ou use as APIs assíncronas do Firecrawl com webhooks.
</Note>

<div id="use-firecrawl-with-the-vercel-ai-sdk">
  ## Use o Firecrawl com o Vercel AI SDK
</div>

Se você estiver criando um agente com o [Vercel AI SDK](/pt-BR/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk), instale as ferramentas do Firecrawl AI SDK:

```bash theme={null}
npm install firecrawl-aisdk ai
```

Em seguida, passe as ferramentas do Firecrawl para o seu modelo. A `FIRECRAWL_API_KEY` instalada pelo Marketplace é obtida do ambiente.

<Note>
  O exemplo abaixo usa o formato de string de modelo do Vercel AI Gateway. Configure separadamente o provedor de modelo do AI SDK ou as credenciais do AI Gateway.
</Note>

```typescript theme={null}
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);
```

<div id="next-steps">
  ## Próximos passos
</div>

<CardGroup cols={2}>
  <Card title="Guia de início rápido do Vercel Functions" icon="bolt" href="/pt-BR/quickstarts/vercel-functions">
    Use o Firecrawl no Vercel Functions com configuração manual de ambiente
  </Card>

  <Card title="Guia do Vercel AI SDK" icon="puzzle-piece" href="/pt-BR/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk">
    Adicione ferramentas do Firecrawl aos agentes do Vercel AI SDK
  </Card>

  <Card title="Documentação de scraping" icon="file-lines" href="/pt-BR/features/scrape">
    Converta páginas da web em Markdown, JSON, capturas de tela e muito mais
  </Card>

  <Card title="Documentação de busca" icon="magnifying-glass" href="/pt-BR/features/search">
    Faça uma busca na web e obtenha o conteúdo das páginas a partir dos resultados
  </Card>
</CardGroup>