ElevenAgents

Donnez aux agents vocaux et conversationnels ElevenLabs un accès au web en temps réel avec Firecrawl

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

• Un compte ElevenLabs avec accès à ElevenAgents
• Une clé API Firecrawl depuis le dashboard firecrawl.dev

​

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 :

Champ	Valeur
Name	Firecrawl
Description	Recherche, scraping, crawl et extraction de contenu sur n’importe quel site web.
Server type	Streamable HTTP
Server URL	https://mcp.firecrawl.dev/v2/mcp

Cette URL lance l’ensemble d’outils Firecrawl sans clé. Pour une configuration connectée à un compte ou sans surveillance, suivez les modes de connexion MCP hébergés ; conservez les clés API dans un en-tête Authorization ou un magasin de secrets sécurisé, jamais dans une URL.

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.

4. 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.

5. 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 :

Vous êtes un assistant de recherche serviable. Lorsque l'utilisateur pose une question sur un site web,
une entreprise ou tout sujet nécessitant des informations à jour, utilisez les
outils Firecrawl pour rechercher sur le web ou scraper la page concernée, puis
résumez les résultats.

​

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 :

Champ	Valeur
Name	scrape_website
Description	Scrape le contenu d’une URL et le renvoie en markdown propre.
Method	POST
URL	https://api.firecrawl.dev/v2/scrape

Le champ Method est défini sur GET par défaut — veillez à le remplacer par POST.

4. Faites défiler jusqu’à la section Headers, puis cliquez sur Add header pour configurer l’authentification :

En-tête	Valeur
Authorization	Bearer YOUR_FIRECRAWL_API_KEY

Sinon, si des connexions d’authentification de l’espace de travail sont configurées, vous pouvez utiliser le menu déroulant Authentication à la place.

5. Ajoutez un paramètre dans le corps de la requête :

Paramètre	Type	Description	Obligatoire
url	string	L’URL à scraper	Oui

6. 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 :

Champ	Valeur
Name	search_web
Description	Effectuer une recherche sur le web à partir d’une requête et renvoyer des résultats pertinents avec le contenu des pages.
Method	POST
URL	https://api.firecrawl.dev/v2/search

2. Ajoutez le même en-tête Authorization que ci-dessus.

3. Ajoutez des paramètres dans le corps :

Paramètre	Type	Description	Obligatoire
query	string	La requête de recherche	Oui
limit	number	Nombre maximal de résultats à renvoyer (5 par défaut)	Non

4. Cliquez sur Add tool.

​

Mettre à jour le prompt système

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

Vous êtes un assistant compétent ayant accès à des outils web.

- Utilisez `scrape_website` lorsque l'utilisateur vous fournit une URL spécifique à lire.
- Utilisez `search_web` lorsque l'utilisateur pose une question générale nécessitant
  de trouver des informations en ligne.

Résumez toujours les informations de manière concise et citez l'URL source.

​

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

• Documentation d’ElevenAgents
• Présentation des outils ElevenAgents
• Intégration MCP d’ElevenAgents
• Référence de l’API Firecrawl
• Serveur MCP de Firecrawl