# Astro (/pt-BR/quickstarts/astro)
Related: [Node.js](/pt-BR/quickstarts/nodejs.md), [Next.js](/pt-BR/quickstarts/nextjs.md), [Express](/pt-BR/quickstarts/express.md), [NestJS](/pt-BR/quickstarts/nestjs.md), [Fastify](/pt-BR/quickstarts/fastify.md), [Hono](/pt-BR/quickstarts/hono.md)
## Pré-requisitos [#pré-requisitos]
* Um projeto Astro com SSR habilitado (`output: "server"` ou `"hybrid"`)
* Uma chave de API do Firecrawl — [obtenha uma gratuitamente](https://www.firecrawl.dev/app/api-keys)
## Instalar o SDK [#instalar-o-sdk]
```bash
npm install firecrawl
```
Adicione sua chave de API ao `.env`:
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Fazer uma busca na web [#fazer-uma-busca-na-web]
Crie `src/pages/api/search.ts`:
```typescript
import type { APIRoute } from "astro";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: import.meta.env.FIRECRAWL_API_KEY,
});
export const POST: APIRoute = async ({ request }) => {
const { query } = await request.json();
const results = await firecrawl.search(query, { limit: 5 });
return new Response(JSON.stringify(results), {
headers: { "Content-Type": "application/json" },
});
};
```
Ou faça a busca em tempo de requisição em uma página renderizada no servidor (`src/pages/search.astro`):
```astro
---
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: import.meta.env.FIRECRAWL_API_KEY,
});
const query = Astro.url.searchParams.get("q");
let results = [];
if (query) {
const searchData = await firecrawl.search(query, { limit: 5 });
results = searchData.web || [];
}
---
Resultados de Busca
{results.length > 0 ? (
) : (
Passe ?q= para fazer uma busca na web
)}
```
## Executar scraping em uma página [#executar-scraping-em-uma-página]
Crie `src/pages/api/scrape.ts`:
```typescript
import type { APIRoute } from "astro";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: import.meta.env.FIRECRAWL_API_KEY,
});
export const POST: APIRoute = async ({ request }) => {
const { url } = await request.json();
const result = await firecrawl.scrape(url);
return new Response(JSON.stringify(result), {
headers: { "Content-Type": "application/json" },
});
};
```
Ou faça scraping durante a requisição em uma página renderizada no servidor (`src/pages/scrape.astro`):
```astro
---
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: import.meta.env.FIRECRAWL_API_KEY,
});
const target = Astro.url.searchParams.get("url");
let markdown = null;
if (target) {
const result = await firecrawl.scrape(target);
markdown = result.markdown;
}
---
Conteúdo Extraído
{markdown ? {markdown} : Passe ?url= para fazer scraping de uma página
}
```
## Interaja com uma página [#interaja-com-uma-página]
Crie `src/pages/api/interact.ts`:
```typescript
import type { APIRoute } from "astro";
import { Firecrawl } from "firecrawl";
const firecrawl = new Firecrawl({
apiKey: import.meta.env.FIRECRAWL_API_KEY,
});
export const POST: APIRoute = async () => {
const result = await firecrawl.scrape("https://www.amazon.com", {
formats: ["markdown"],
});
const scrapeId = result.metadata?.scrapeId;
await firecrawl.interact(scrapeId, {
prompt: "Search for iPhone 16 Pro Max",
});
const response = await firecrawl.interact(scrapeId, {
prompt: "Click on the first result and tell me the price",
});
await firecrawl.stopInteraction(scrapeId);
return new Response(JSON.stringify({ output: response.output }), {
headers: { "Content-Type": "application/json" },
});
};
```
## Próximos passos [#próximos-passos]
Todas as opções de scraping, incluindo formatos, ações e proxies
Faça uma busca na web e obtenha o conteúdo completo da página
Clique, preencha formulários e extraia conteúdo dinâmico
Referência completa do SDK com rastreamento, map, extração em lote e muito mais