Hono

Utilisez Firecrawl avec Hono pour créer des API légères de scraping web et de recherche qui fonctionnent partout.

Prérequis

Node.js 18+, Bun ou Deno
Une clé API Firecrawl — obtenez-en une gratuitement

Configuration

npm install hono firecrawl

Ajoutez votre clé API dans .env :

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

Rechercher sur le Web

import { Hono } from "hono";
import { Firecrawl } from "firecrawl";

const app = new Hono();
const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

app.post("/search", async (c) => {
  const { query } = await c.req.json();
  const results = await firecrawl.search(query, { limit: 5 });
  return c.json(results);
});

export default app;

Scrape d’une page

app.post("/scrape", async (c) => {
  const { url } = await c.req.json();
  const result = await firecrawl.scrape(url);
  return c.json(result);
});

Interact avec une page

Utilisez Interact pour contrôler une session de navigateur en direct : cliquez sur des boutons, remplissez des formulaires et extrayez du contenu dynamique.

app.post("/interact", async (c) => {
  const { url } = await c.req.json();

  const result = await firecrawl.scrape(url, { 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 c.json({ output: response.output });
});

Déployez n’importe où

Hono fonctionne dans plusieurs environnements d’exécution. Pour Cloudflare Workers, transmettez la clé API via la liaison d’environnement :

import { Hono } from "hono";
import { Firecrawl } from "firecrawl";

type Bindings = { FIRECRAWL_API_KEY: string };
const app = new Hono<{ Bindings: Bindings }>();

app.post("/search", async (c) => {
  const firecrawl = new Firecrawl({ apiKey: c.env.FIRECRAWL_API_KEY });
  const { query } = await c.req.json();
  const results = await firecrawl.search(query, { limit: 5 });
  return c.json(results);
});

export default app;

Étapes suivantes

Docs Scrape

Toutes les options de scrape, y compris les formats, les actions et les proxies

Docs recherche

Effectuez une recherche sur le web et obtenez le contenu complet de la page

Docs Interact

Cliquez, remplissez des formulaires et extrayez du contenu dynamique

Référence du SDK Node

Référence complète du SDK avec crawl, cartographie, extraction par lot et plus encore