Skip to main content

ElevenAgents

Dales a los agentes de voz y chat de ElevenLabs acceso a la web en tiempo real con Firecrawl
5 min read

Dales a tus agentes de voz y chat de ElevenAgents acceso a 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:
CampoValor
NameFirecrawl
DescriptionBusca, hace scraping y procesa contenido web con Firecrawl.
Server typeStreamable HTTP
Server URLhttps://mcp.firecrawl.dev/v2/mcp

El MCP sin clave ofrece exactamente Search, scraping y procesar, con límites compartidos. Inicia sesión o añade una clave de API para acceder a un conjunto de herramientas más amplio. Conserva las claves de API en una variable de entorno o almacén de secretos, nunca en una URL.

Note

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.
    • 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 sin clave y mostrará Search, scraping y procesar.

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:
CampoValor
Namescrape_website
DescriptionHaz scraping del contenido de una URL y devuélvelo como markdown limpio.
MethodPOST
URLhttps://api.firecrawl.dev/v2/scrape
Note

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:
EncabezadoValor
AuthorizationBearer YOUR_FIRECRAWL_API_KEY

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:
ParámetroTipoDescripciónObligatorio
urlstringLa URL de la que se hará scraping
  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:
CampoValor
Nombresearch_web
DescripciónBusca en la web una consulta y devuelve resultados relevantes con el contenido de la página.
MétodoPOST
URLhttps://api.firecrawl.dev/v2/search
  1. Añade el mismo encabezado Authorization que antes.

  2. Añade parámetros del cuerpo:

ParámetroTipoDescripciónObligatorio
querystringLa consulta de búsqueda
limitnumberNúmero máximo de resultados que se devolverán (predeterminado: 5)No
  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#