SvelteKit

Usa Firecrawl con SvelteKit para hacer scraping, buscar e interactuar con datos web en tu aplicación Svelte.

Requisitos previos

Un proyecto con SvelteKit
Una clave de API de Firecrawl — obtén una gratis

Instala el SDK

npm install firecrawl

Añade tu clave de API a .env:

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

Buscar en la web

Crea una action de formulario en src/routes/search/+page.server.ts:

import { Firecrawl } from "firecrawl";
import { FIRECRAWL_API_KEY } from "$env/static/private";

const firecrawl = new Firecrawl({ apiKey: FIRECRAWL_API_KEY });

export const actions = {
  default: async ({ request }) => {
    const data = await request.formData();
    const query = data.get("query") as string;
    const results = await firecrawl.search(query, { limit: 5 });
    return { results: (results.web || []).map((r) => ({ title: r.title, url: r.url })) };
  },
};

Configúralo en src/routes/search/+page.svelte:

<script>
  export let form;
</script>

<form method="POST">
  <input name="query" placeholder="Search the web..." />
  <button>Search</button>
</form>

{#if form?.results}
  {#each form.results as result}
    <div><a href={result.url}>{result.title}</a></div>
  {/each}
{/if}

Hacer scraping de una página

Obtén datos en la función load en src/routes/scrape/+page.server.ts:

import { Firecrawl } from "firecrawl";
import { FIRECRAWL_API_KEY } from "$env/static/private";

const firecrawl = new Firecrawl({ apiKey: FIRECRAWL_API_KEY });

export async function load({ url }) {
  const target = url.searchParams.get("url");
  if (!target) return { markdown: null };

  const result = await firecrawl.scrape(target);
  return { markdown: result.markdown };
}

Muéstralo en src/routes/scrape/+page.svelte:

<script>
  export let data;
</script>

{#if data.markdown}
  <pre>{data.markdown}</pre>
{:else}
  <p>Pasa ?url= para hacer scraping de una página</p>
{/if}

Interactúa con una página

Crea un endpoint del servidor en src/routes/api/interact/+server.ts:

import { json } from "@sveltejs/kit";
import { Firecrawl } from "firecrawl";
import { FIRECRAWL_API_KEY } from "$env/static/private";

const firecrawl = new Firecrawl({ apiKey: FIRECRAWL_API_KEY });

export async function POST() {
  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 json({ output: response.output });
}

Próximos pasos

Documentación de scraping

Todas las opciones de scraping, incluidos los formatos, las acciones y los proxies

Documentación de búsqueda

Busca en la web y obtén el contenido completo de la página

Documentación de Interact

Haz clic, completa formularios y extrae contenido dinámico

Referencia del SDK de Node

Referencia completa del SDK con crawl, mapeo, extracción por lotes y más