Skip to main content
Dales a tus agentes de voz y chat de ElevenAgents la capacidad de hacer scraping, buscar y rastrear la web en tiempo real con Firecrawl. Esta guía cubre dos opciones de integración:
  1. MCP Server — conecta el MCP Server alojado de Firecrawl para una configuración sin código.
  2. Herramienta de webhook del servidor — dirige una herramienta personalizada a la API REST de Firecrawl para tener control total sobre las solicitudes.

Requisitos previos

Opción 1: Firecrawl MCP Server

La forma más rápida de dar acceso web a un agente. ElevenAgents admite servidores MCP remotos y Firecrawl proporciona un endpoint MCP alojado.

Añade el MCP Server

  1. Abre la página de integraciones en ElevenLabs y haz clic en + Add integration.
  2. Selecciona Custom MCP Server en la biblioteca de integraciones.
  3. Completa los siguientes campos:
Sustituye YOUR_FIRECRAWL_API_KEY por tu clave real. Deja el menú desplegable Type en Value. Trata esta URL como un secreto: contiene tu API key.
Debes seleccionar Streamable HTTP como tipo de servidor. La opción predeterminada SSE no funciona con el endpoint MCP de Firecrawl.
  1. En Tool Approval Mode, selecciona un nivel de aprobación:
    • No Approval — el agente usa las herramientas libremente. Adecuado para scraping de solo lectura.
    • Fine-Grained Tool Approval — te permite preseleccionar qué herramientas pueden ejecutarse automáticamente y cuáles requieren aprobación. Útil para controlar operaciones de crawl costosas.
    • Always Ask (predeterminado) — el agente solicita permiso antes de cada llamada de herramienta.
  2. Marca I trust this server y luego haz clic en Add Server.
ElevenLabs se conectará al servidor y mostrará las herramientas disponibles (scrape, search, crawl, map y más).

Añádelo a un agente

  1. Crea o abre un agente en el panel de ElevenAgents.
  2. Ve a la pestaña Tools y, a continuación, selecciona la subpestaña MCP.
  3. Haz clic en Add server y selecciona la integración de Firecrawl en el menú desplegable.

Actualiza el prompt del sistema

En la pestaña Agent, agrega instrucciones al System prompt para que el agente sepa cuándo usar Firecrawl. Por ejemplo:

Pruébalo

Haz clic en Preview en la barra de navegación superior. Puedes probarlo usando el campo de chat de texto o iniciando una llamada de voz. Prueba un prompt como:
“¿Qué hace firecrawl.dev? Ve al sitio y resúmelo.”
El agente llamará a la herramienta MCP scrape de Firecrawl, recibirá el markdown de la página y responderá con un resumen.

Opción 2: Herramienta de Webhook del servidor

Usa este enfoque cuando necesites un control preciso sobre los parámetros de la solicitud (formatos, encabezados, timeouts, etc.) o quieras invocar un endpoint específico de Firecrawl sin exponer todo el conjunto de herramientas de MCP.

Herramienta de scraping

Crea una herramienta que haga scraping de una única URL y devuelva su contenido en markdown.
  1. Abre tu agente y ve a la pestaña Tools.
  2. Haz clic en Add tool y selecciona Webhook.
  3. Configura la herramienta:
El campo Method usa GET de forma predeterminada; asegúrate de cambiarlo a POST.
  1. Desplázate hasta la sección Headers y haz clic en Add header para configurar la autenticación:
Como alternativa, si tienes configuradas conexiones de autenticación del espacio de trabajo, puedes usar el menú desplegable Authentication.
  1. Agrega un parámetro en el body:
  1. Haz clic en Add tool.
La API de Firecrawl devuelve el contenido de la página en markdown de forma predeterminada. El agente recibe la respuesta JSON y puede usar el campo markdown para responder preguntas.

Herramienta de búsqueda

Crea una herramienta para buscar en la web y devolver resultados con contenido extraído.
  1. Haz clic en Add toolWebhook de nuevo y configura:
  1. Añade el mismo encabezado Authorization que antes.
  2. Añade parámetros del cuerpo:
  1. Haz clic en Add tool.

Actualiza el System prompt

En la pestaña Agent, actualiza el System prompt:

Pruébalo

Haz clic en Preview y prueba a preguntar:
“Busca las últimas novedades de Next.js y dame un resumen.”
El agente llamará a search_web, recibirá resultados de Firecrawl y responderá con un resumen de lo encontrado.

Consejos

  • Selección de modelo — Para una invocación de herramientas fiable, usa un modelo de alta capacidad como GPT-4o, Claude Sonnet 4.5 o posterior, o Gemini 2.5 Flash. Los modelos más pequeños pueden tener dificultades para extraer los parámetros correctos.
  • Mantén los prompts específicos — Indica al agent exactamente cuándo usar cada herramienta. Las instrucciones vagas provocan invocaciones de herramientas omitidas o incorrectas.
  • Limita el tamaño de la respuesta — En los agentes de voz, las páginas largas extraídas mediante scraping pueden saturar el contexto del LLM. Usa onlyMainContent: true en las scrape options (o indícale al agent que resuma de forma agresiva) para mantener las respuestas concisas.
  • Sonidos de invocación de herramientas — En la configuración de herramientas de Webhook o MCP, puedes configurar un sonido de invocación de herramientas para reproducir audio ambiental mientras se ejecuta una herramienta. Esto le indica al usuario que el agent está trabajando.

Recursos