> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://elevenlabs.io/agents) 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.

<div id="prerequisites">
  ## Prérequis
</div>

* Un compte [ElevenLabs](https://elevenlabs.io) avec accès à ElevenAgents
* Une clé API Firecrawl depuis le [dashboard firecrawl.dev](https://firecrawl.dev)

<div id="option-1-firecrawl-mcp-server">
  ## Option 1 : serveur MCP Firecrawl
</div>

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

<div id="add-the-mcp-server">
  ### Ajouter le serveur MCP
</div>

1. Ouvrez la [page Integrations](https://elevenlabs.io/app/agents/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/YOUR_FIRECRAWL_API_KEY/v2/mcp`                        |

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.

<Note>
  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.
</Note>

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

<div id="attach-it-to-an-agent">
  ### L’associer à un agent
</div>

1. Créez ou ouvrez un agent dans le [tableau de bord ElevenAgents](https://elevenlabs.io/app/agents/agents).
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.

<div id="update-the-system-prompt">
  ### Mettez à jour le prompt système
</div>

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

```text theme={null}
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é.

***

<div id="option-2-server-webhook-tool">
  ## Option 2 : Outil Webhook côté serveur
</div>

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.

<div id="scrape-tool">
  ### Outil de scraping
</div>

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`                         |

<Note>
  Le champ **Method** est défini sur GET par défaut — veillez à le remplacer par **POST**.
</Note>

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.

<div id="search-tool">
  ### Outil de recherche
</div>

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** :

```text theme={null}
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.
```

<div id="test-it">
  ### Essayez-le
</div>

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.

***

<div id="tips">
  ## Conseils
</div>

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

<div id="resources">
  ## Ressources
</div>

* [Documentation d'ElevenAgents](https://elevenlabs.io/docs/eleven-agents/overview)
* [Présentation des outils ElevenAgents](https://elevenlabs.io/docs/eleven-agents/customization/tools)
* [Intégration MCP d'ElevenAgents](https://elevenlabs.io/docs/eleven-agents/customization/tools/mcp)
* [Référence de l'API Firecrawl](https://docs.firecrawl.dev/api-reference/v2-introduction)
* [Serveur MCP de Firecrawl](https://docs.firecrawl.dev/mcp-server)