Skip to main content
Donnez à vos agents vocaux et conversationnels ElevenAgents la capacité de scraper, de rechercher et de crawl le web en temps réel avec Firecrawl. Ce guide couvre deux approches d’intégration :
  1. serveur MCP — connectez le serveur MCP Firecrawl hébergé pour une configuration sans code.
  2. outil webhook côté serveur — faites pointer un outil personnalisé vers l’API REST de Firecrawl pour un contrôle total sur les requêtes.

​
Prérequis

​
Option 1 : serveur MCP Firecrawl

Le moyen le plus rapide de donner à un agent l’accès au web. ElevenAgents prend en charge les serveurs MCP distants, et Firecrawl fournit un point de terminaison MCP hébergé.

​
Ajouter le serveur MCP

  1. Ouvrez la page Integrations dans ElevenLabs et cliquez sur + Add integration.
  2. Sélectionnez Custom MCP Server dans la bibliothèque d’intégrations.
  3. Renseignez les champs suivants :
Remplacez YOUR_FIRECRAWL_API_KEY par votre véritable clé API. Laissez la liste déroulante Type définie sur Value. Considérez cette URL comme un secret : elle contient votre clé API.
Vous devez sélectionner Streamable HTTP comme type de serveur. L’option SSE par défaut ne fonctionne pas avec le point de terminaison MCP de Firecrawl.
  1. Dans Tool Approval Mode, choisissez un niveau d’approbation :
    • No Approval — l’agent utilise les outils librement. Convient pour le scraping en lecture seule.
    • Fine-Grained Tool Approval — permet de présélectionner les outils qui peuvent s’exécuter automatiquement et ceux qui nécessitent une approbation. Utile pour contrôler les opérations de crawl coûteuses.
    • Always Ask (par défaut) — l’agent demande une autorisation avant chaque appel d’outil.
  2. Cochez I trust this server, puis cliquez sur Add Server.
ElevenLabs se connectera au serveur et affichera la liste des outils disponibles (scrape, recherche, crawl, cartographie, etc.).

​
L’associer à un agent

  1. Créez ou ouvrez un agent dans le tableau de bord ElevenAgents.
  2. Accédez à l’onglet Tools, puis sélectionnez le sous-onglet MCP.
  3. Cliquez sur Add server et sélectionnez l’intégration Firecrawl dans le menu déroulant.

​
Mettez à jour le prompt système

Dans l’onglet Agent, ajoutez des instructions au prompt système afin que l’agent sache quand utiliser Firecrawl. Par exemple :

​
Testez-le

Cliquez sur Preview dans la barre de navigation supérieure. Vous pouvez le tester via le champ de chat textuel ou en lançant un appel vocal. Essayez avec une requête comme :
“Que fait firecrawl.dev ? Va sur le site et résume-le-moi.”
L’agent appellera l’outil MCP Firecrawl scrape, récupérera le markdown de la page et répondra avec un résumé.

​
Option 2 : Outil Webhook côté serveur

Utilisez cette approche lorsque vous avez besoin d’une maîtrise précise des paramètres de requête (formats, en-têtes, délais d’expiration, etc.) ou que vous souhaitez appeler un point de terminaison Firecrawl spécifique sans exposer l’ensemble des outils MCP.

​
Outil de scraping

Créez un outil qui scrape une seule URL et renvoie son contenu au format markdown.
  1. Ouvrez votre agent, puis accédez à l’onglet Tools.
  2. Cliquez sur Add tool, puis sélectionnez Webhook.
  3. Configurez l’outil :
Le champ Method est défini sur GET par défaut — veillez à le remplacer par POST.
  1. Faites défiler jusqu’à la section Headers, puis cliquez sur Add header pour configurer l’authentification :
Sinon, si des connexions d’authentification de l’espace de travail sont configurées, vous pouvez utiliser le menu déroulant Authentication à la place.
  1. Ajoutez un paramètre dans le corps de la requête :
  1. Cliquez sur Add tool.
L’API Firecrawl renvoie par défaut le contenu de la page au format markdown. L’agent reçoit la réponse JSON et peut utiliser le champ markdown pour répondre aux questions.

​
Outil de recherche

Créez un outil qui effectue une recherche sur le web et renvoie des résultats avec le contenu extrait.
  1. Cliquez à nouveau sur Add tool → Webhook et configurez :
  1. Ajoutez le même en-tête Authorization que ci-dessus.
  2. Ajoutez des paramètres dans le corps :
  1. Cliquez sur Add tool.

​
Mettre à jour le prompt système

Dans l’onglet Agent, mettez à jour le prompt système :

​
Essayez-le

Cliquez sur Preview et essayez de demander :
“Recherchez les dernières fonctionnalités de Next.js et faites-m’en un résumé.”
L’agent appellera search_web, recevra les résultats de Firecrawl et répondra par un résumé des informations trouvées.

​
Conseils

  • Choix du modèle — Pour des appels d’outils fiables, utilisez un modèle performant comme GPT-4o, Claude Sonnet 4.5 ou version ultérieure, ou Gemini 2.5 Flash. Les modèles plus petits peuvent avoir du mal à extraire les bons paramètres.
  • Gardez des prompts précis — Indiquez à l’agent exactement quand utiliser chaque outil. Des instructions vagues entraînent des appels d’outils manqués ou erronés.
  • Limitez la taille des réponses — Pour les agents vocaux, de longues pages scrapées peuvent saturer le contexte du LLM. Utilisez onlyMainContent: true dans les options de scrape (ou demandez à l’agent de résumer de façon très concise) pour garder des réponses courtes.
  • Sons d’appel d’outil — Dans les paramètres de l’outil webhook ou MCP, vous pouvez configurer un son d’appel d’outil pour diffuser un son d’ambiance pendant l’exécution d’un outil. Cela indique à l’utilisateur que l’agent est en train de travailler.

​
Ressources