Guia de início rápido do Astro

Pré-requisitos

Um projeto Astro com SSR habilitado (output: "server" ou "hybrid")
Uma chave de API do Firecrawl — obtenha uma gratuitamente

Instalar o SDK

npm install firecrawl

Adicione sua chave de API ao .env:

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

Fazer uma busca na web

Crie src/pages/api/search.ts:

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):

---
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 || [];
}
---

<html>
  <body>
    <h1>Resultados de Busca</h1>
    {results.length > 0 ? (
      <ul>
        {results.map((r) => (
          <li><a href={r.url}>{r.title}</a></li>
        ))}
      </ul>
    ) : (
      <p>Passe ?q= para fazer uma busca na web</p>
    )}
  </body>
</html>

Executar scraping em uma página

Crie src/pages/api/scrape.ts:

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):

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

<html>
  <body>
    <h1>Conteúdo Extraído</h1>
    {markdown ? <pre>{markdown}</pre> : <p>Passe ?url= para fazer scraping de uma página</p>}
  </body>
</html>

Interaja com uma página

Crie src/pages/api/interact.ts:

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

Docs de scraping

Todas as opções de scraping, incluindo formatos, ações e proxies

Docs de busca

Faça uma busca na web e obtenha o conteúdo completo da página

Docs de interação

Clique, preencha formulários e extraia conteúdo dinâmico

Referência do SDK de Node

Referência completa do SDK com rastreamento, map, extração em lote e muito mais

Primeiros passos

Endpoints principais

Mais

Guias de início rápido

Guias para desenvolvedores

Webhooks

Casos de uso

Outros

Como contribuir

Astro

Pré-requisitos

Instalar o SDK

Fazer uma busca na web

Executar scraping em uma página

Interaja com uma página

Próximos passos

Docs de scraping

Docs de busca

Docs de interação

Referência do SDK de Node

​Pré-requisitos

​Instalar o SDK

​Fazer uma busca na web

​Executar scraping em uma página

​Interaja com uma página

​Próximos passos

Docs de scraping

Docs de busca

Docs de interação

Referência do SDK de Node

Pré-requisitos

Instalar o SDK

Fazer uma busca na web

Executar scraping em uma página

Interaja com uma página

Próximos passos