Skip to main content
Connectez les modèles OpenAI à Firecrawl en ajoutant le serveur MCP hébergé en tant qu’outil mcp distant dans l’API Responses. OpenAI récupère la liste des outils Firecrawl, que le modèle appelle ensuite pour effectuer des recherches sur le web et lire des pages.
D’après la documentation d’OpenAI, l’arrêt d’Agent Builder est prévu pour le 30 novembre 2026. L’outil MCP distant présenté sur cette page ne dépend pas d’Agent Builder.

Prérequis

  • Une clé API OpenAI dans OPENAI_API_KEY et le package Python openai.
  • Une clé API Firecrawl dans FIRECRAWL_API_KEY.

Configuration rapide

Ajoutez le serveur Firecrawl à la liste tools. Le champ authorization contient votre clé API Firecrawl, tandis que allowed_tools restreint les outils que le modèle peut appeler :
OpenAI ne conserve pas la valeur authorization : vous devez donc l’envoyer à chaque requête. Définissez require_approval sur "always" si vous souhaitez vérifier chaque appel d’outil avant que les données ne soient envoyées au serveur. Voir Configurer une clé API pour en savoir plus sur les connexions par clé. Avec cette configuration, votre code n’effectue aucun appel direct à l’API Firecrawl, car OpenAI se connecte au serveur MCP à votre place.

Essayer

Ce que vous pouvez faire

Recherche

Trouvez des informations à jour et consultez le contenu des résultats pertinents.

Extraction

Convertissez des URL en markdown propre ou en données structurées.

Interact

Naviguez, cliquez et remplissez des formulaires pour accéder aux données dont vous avez besoin.

Alexandria

Découvrez des outils de données structurées, consultez leurs paramètres d’entrée et leur tarification, puis exécutez-les via Firecrawl.

Dépannage

  • La requête échoue lors de la récupération de la liste des outils : vérifiez que server_url vaut exactement https://mcp.firecrawl.dev/v2/mcp et que FIRECRAWL_API_KEY est défini dans l’environnement qui exécute le script.
  • Le serveur renvoie 401 : remplacez la clé et renvoyez la requête, car OpenAI ne conserve pas la valeur authorization d’une requête à l’autre.
  • Un outil est manquant : ajoutez son nom à allowed_tools, ou supprimez allowed_tools pour importer tous les outils exposés par le serveur.
  • Le modèle répond sans utiliser Firecrawl : indiquez le nom de l’outil dans votre prompt, par exemple « Utilise firecrawl_search pour trouver… ».