Firecrawl

Firecrawl

OpenClaw puede usar Firecrawl de tres maneras:

• como el proveedor web_search
• como herramientas de complemento explícitas: firecrawl_search y firecrawl_scrape
• como un extractor de alternativa para web_fetch

Es un servicio alojado de extracción/búsqueda que admite la evasión de bots y el almacenamiento en caché, lo cual ayuda con sitios con mucho JS o páginas que bloquean las recuperaciones HTTP simples.

Obtener una clave de API

1. Cree una cuenta de Firecrawl y genere una clave de API.
2. Guárdela en la configuración o establezca FIRECRAWL_API_KEY en el entorno de la puerta de enlace.

Configurar la búsqueda de Firecrawl

{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}

Notas:

• Elegir Firecrawl en la incorporación o openclaw configure --section web habilita automáticamente el complemento Firecrawl incluido.
• web_search con Firecrawl admite query y count.
• Para controles específicos de Firecrawl como sources, categories, o el raspado de resultados, use firecrawl_search.

Configurar raspado de Firecrawl + alternativa web_fetch

{
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
      },
    },
  },
  tools: {
    web: {
      fetch: {
        firecrawl: {
          apiKey: "FIRECRAWL_API_KEY_HERE",
          baseUrl: "https://api.firecrawl.dev",
          onlyMainContent: true,
          maxAgeMs: 172800000,
          timeoutSeconds: 60,
        },
      },
    },
  },
}

Notas:

• firecrawl.enabled por defecto es true a menos que se establezca explícitamente en false.
• Los intentos de alternativa de Firecrawl se ejecutan solo cuando hay una clave de API disponible (tools.web.fetch.firecrawl.apiKey o FIRECRAWL_API_KEY).
• maxAgeMs controla la antigüedad máxima de los resultados en caché (ms). El valor predeterminado es 2 días.

firecrawl_scrape reutiliza la misma configuración y variables de entorno de tools.web.fetch.firecrawl.*.

Herramientas del complemento Firecrawl

firecrawl_search

Use esto cuando desee controles de búsqueda específicos de Firecrawl en lugar de web_search genérico.

Parámetros principales:

• query
• count
• sources
• categories
• scrapeResults
• timeoutSeconds

firecrawl_scrape

Use esto para páginas con mucho JS o protegidas por bots donde el web_fetch simple es débil.

Parámetros principales:

• url
• extractMode
• maxChars
• onlyMainContent
• maxAgeMs
• proxy
• storeInCache
• timeoutSeconds

Sigilo / evasión de bots

Firecrawl expone un parámetro de modo proxy para la evasión de bots (basic, stealth o auto). OpenClaw siempre usa proxy: "auto" más storeInCache: true para las solicitudes de Firecrawl. Si se omite el proxy, Firecrawl usa por defecto auto. auto reintentará con proxies sigilosos si falla un intento básico, lo que puede usar más créditos que el scraping básico únicamente.

Cómo web_fetch usa Firecrawl

Orden de extracción de web_fetch:

1. Readability (local)
2. Firecrawl (si está configurado)
3. Limpieza básica de HTML (último recurso)

Relacionado

• Resumen de búsqueda web — todos los proveedores y detección automática
• Web Fetch — herramienta web_fetch con respaldo Firecrawl
• Tavily — herramientas de búsqueda y extracción