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 :
- serveur MCP — connectez le serveur MCP Firecrawl hébergé pour une configuration sans code.
- 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.
Option 1 : serveur MCP Firecrawl
- Ouvrez la page Integrations dans ElevenLabs et cliquez sur + Add integration.
- Sélectionnez Custom MCP Server dans la bibliothèque d’intégrations.
- 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/YOUR_FIRECRAWL_API_KEY/v2/mcp |
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.
-
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.
-
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.).
- Créez ou ouvrez un agent dans le tableau de bord ElevenAgents.
- Accédez à l’onglet Tools, puis sélectionnez le sous-onglet MCP.
- Cliquez sur Add server et sélectionnez l’intégration Firecrawl dans le menu déroulant.
Mettez à jour le prompt système
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é.
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.
Créez un outil qui scrape une seule URL et renvoie son contenu au format markdown.
- Ouvrez votre agent, puis accédez à l’onglet Tools.
- Cliquez sur Add tool, puis sélectionnez Webhook.
- 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.
- 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 |
- Ajoutez un paramètre dans le corps de la requête :
| Paramètre | Type | Description | Obligatoire |
|---|
url | string | L’URL à scraper | Oui |
- 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.
Créez un outil qui effectue une recherche sur le web et renvoie des résultats avec le contenu extrait.
- 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 |
-
Ajoutez le même en-tête
Authorization que ci-dessus.
-
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 |
- 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.
“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.
- 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.
