SvelteKit - Firecrawl Docs

前提条件#

SvelteKit 项目
Firecrawl API 密钥 — 免费获取一个

安装 SDK#

npm install firecrawl

将 API 密钥添加到 .env：

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

进行网页搜索#

在 src/routes/search/+page.server.ts 中创建表单 action：

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

在 src/routes/search/+page.svelte 中完成接入：

<script>  export let form;</script><form method="POST">  <input name="query" placeholder="进行网页搜索..." />  <button>搜索</button></form>{#if form?.results}  {#each form.results as result}    <div><a href={result.url}>{result.title}</a></div>  {/each}{/if}

抓取页面#

在 src/routes/scrape/+page.server.ts 的 load 函数中获取数据：

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

在 src/routes/scrape/+page.svelte 中显示它：

<script>  export let data;</script>{#if data.markdown}  <pre>{data.markdown}</pre>{:else}  <p>Pass ?url= to scrape a page</p>{/if}

与页面交互#

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

后续步骤#

抓取文档

包含所有抓取选项，如 formats、actions 和代理

搜索文档

进行网页搜索并获取完整页面内容

交互文档

点击、填写表单并提取动态内容

Node SDK 参考

完整的 SDK 参考，涵盖爬取、map、batch 抓取等功能