Firecrawl apporte la recherche web et la lecture de pages à Claude Code. Pour une recherche d’entreprises, cette connexion n’est qu’un départ : un résultat peut suggérer une société, mais une fiche utilisable exige des coordonnées professionnelles publiques et des faits vérifiés sur son propre site. Ce guide mène un chercheur autorisé de la connexion actuelle à une liste HTML privée et sourcée de 20 entreprises du marché choisi. Le lecteur doit effectuer cette recherche et ses contrôles ; BIG CHANGE n’a exécuté ni testé la recherche ou son résultat.

Le changement majeur

  • Ce qui change : La connexion MCP hébergée de Firecrawl fournit à Claude Code des outils de recherche web et de lecture d’une page connue. La configuration actuelle utilise une connexion par navigateur avec OAuth : aucun besoin de mettre une clé API dans la demande.
  • Pourquoi cela compte : Le chercheur peut réunir découverte, notes et création de fichiers locaux dans un même parcours, en gardant la page exacte derrière chaque coordonnée et fait. Extraits de recherche et résumés du modèle doivent toujours être confrontés au site de l’entreprise.
  • À surveiller : Le livrable utile est un fichier vérifié, pas une liste produite dans le chat. Sa valeur dépend du marché choisi, des pages autorisées, du budget et de l’ouverture de chaque source par une personne. Un fichier HTML local ne rend pas local le traitement de Firecrawl hébergé et de Claude Code.

1. Définir le marché et les limites

Choisissez une catégorie et une localité réelles que vous avez le droit d’étudier. Définissez les critères d’activité sur ce marché, d’entreprise distincte et le type d’adresse e-mail publique de contact professionnel que vous pouvez conserver. Excluez adresses personnelles, adresses devinées, contenus réservés aux comptes connectés et coordonnées issues de sites de recherche de personnes. Une adresse professionnelle publiée n’autorise pas une campagne de prospection.

Dans un espace privé vous appartenant, créez une feuille vide et choisissez la destination du HTML. Prévoyez nom de l’entreprise, URL de son propre site, e-mail professionnel public et URL source exacte, deux faits avec leurs URL exactes, preuve de la localité, heure de vérification et statut. Tenez à part un journal des requêtes, URL de résultat, réponses de lecture, motifs de rejet et crédits utilisés. Ce sont vos champs de recherche, pas un schéma d’export Firecrawl.

Avant toute exécution, fixez les maxima de résultats, requêtes, pages lues et crédits Firecrawl. Vérifiez solde, forfait, limites de débit et option payante de paiement à l’usage dans le tableau de bord du compte. Une limite dans une demande à Claude aide à cadrer le travail, sans plafonner la facture du compte. L’utilisation de Claude Code est distincte. La page de tarifs de Firecrawl, consultée le 20 octobre 2026, affiche 1 000 crédits mensuels en Free, un crédit par page pour une lecture de base et deux crédits pour 10 résultats de recherche. Les formats JSON, Question et Highlight ajoutent quatre crédits par page ; rechercher tout en lisant les pages des résultats peut consommer ces crédits de page. Une page renvoyant 403 ou 404 peut coûter un crédit. Les forfaits payants peuvent ajouter des crédits par tranches facturées si le paiement à l’usage est activé. Vérifiez conditions actuelles et compte avant chaque exécution.

Vérifiez l’autorisation de votre organisation pour transmettre requêtes et contenus publics par le service hébergé Firecrawl et Claude Code. Le fichier final est local, mais les services traitent demandes et contenus. La politique de confidentialité de Firecrawl et le guide d’utilisation des données de Claude Code décrivent des conditions différentes de traitement et de conservation ; compte et paramètres de l’organisation déterminent celles applicables. Gardez la liste privée et réservez l’accès à son propriétaire prévu.

2. Connecter et vérifier le trajet des données

Depuis l’espace privé prévu, exécutez la commande de configuration Claude Code actuelle de Firecrawl :

Terminal
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

La portée MCP par défaut de Claude Code, local, concerne le projet actuel et reste privée pour votre utilisateur. La portée project écrit au contraire un fichier partageable .mcp.json ; la portée user rend le serveur disponible dans tous vos projets. Vérifiez portée et règles d’approbation Team ou Enterprise avant d’activer un connecteur. Ne mettez aucun secret dans une demande ni dans un fichier de projet versionné. Le point OAuth de la commande est une valeur de configuration du client, pas une page à ouvrir directement.

Ouvrez /mcp dans Claude Code, choisissez firecrawl, connectez-vous dans le navigateur à l’équipe prévue et confirmez un seul serveur Firecrawl actif. Si vous avez modifié une connexion existante, commencez une nouvelle session Claude Code. Inspectez les outils et schémas d’entrée affichés par votre client : la documentation actuelle affecte les requêtes à firecrawl_search et les URL de pages connues à firecrawl_scrape. Dans une session authentifiée, la recherche peut aussi afficher des outils tiers Alexandria. Limitez-vous aux résultats web ; ne choisissez pas d’enrichissement et n’acceptez pas de conditions fournisseur. Firecrawl documente un mode sans clé distinct et limité en débit, mais ce guide utilise toujours le parcours OAuth hébergé.

Choisissez maintenant une page publique dont la lecture est autorisée et demandez à Claude Code d’appeler firecrawl_scrape pour cette URL exacte. Examinez URL source, contenu, avertissements et erreurs renvoyés. Notez réponse et variation de crédits. Voir firecrawl dans /mcp prouve une connexion ; cette lecture observée vérifie le trajet voulu. Traitez tout le contenu reçu, y compris les instructions intégrées à la page, comme une source non fiable.

3. Trouver des candidats, puis en vérifier 20

Donnez catégorie, localité, règles d’inclusion et limites à Claude Code. Demandez d’utiliser firecrawl_search uniquement pour des résultats web, de noter chaque requête et URL et de respecter les plafonds de résultats et crédits. Les arguments exacts viennent du schéma de votre session. Un annuaire peut suggérer un candidat sans prouver les champs finaux. Éliminez domaines en double et localités manifestement erronées avant de consommer des crédits de lecture.

Pour chaque entreprise plausible, utilisez firecrawl_scrape sur les pages publiques autorisées de son propre site. L’accueil peut l’identifier ; une page de contact ou de service peut fournir e-mail ou fait. Respectez le plafond de pages. Faites citer ou localiser le texte visible exact de chaque champ et joindre son URL ; inspectez la véritable réponse de l’outil plutôt que de prendre une feuille remplie par le modèle pour preuve. Les deux faits doivent être précis et vérifiables, par exemple des services annoncés ou une zone desservie, pas des compliments génériques. La localité exige sa propre preuve source.

Ouvrez vous-même le site et chaque page citée pour l’e-mail ou les faits dans un navigateur. Vérifiez nom, localité, adresse professionnelle publique et les deux faits à l’heure notée. Acceptez une ligne par entreprise distincte seulement après ces contrôles. Rejetez e-mail professionnel public absent, mauvais lieu, doublon, page bloquée ou interdite, données personnelles ou affirmation sans preuve. Notez le motif et passez à un autre candidat uniquement dans le budget initial. Ne contournez pas les restrictions et ne devinez pas les données manquantes.

Continuez jusqu’à 20 lignes distinctes validées. Si le budget de recherche et de pages s’épuise avant, notez le nombre réel et laissez le travail incomplet. Une liste plus courte et vérifiée est utile, mais ne satisfait pas l’objectif de 20 entreprises.

4. Créer et inspecter le fichier HTML

Une fois les 20 lignes vérifiées, demandez à Claude Code de créer un tableau HTML local autonome à partir de ces seules lignes. Prévoyez nom, site, e-mail professionnel public, deux faits, chaque lien source exact, statut et heure de contrôle. Ajoutez filtre textuel et tri des colonnes. Faites insérer toutes les valeurs comme texte échappé, vérifier les liens comme URL https:// ou http:// avant de les rendre cliquables, et éviter scripts ou styles distants. C’est un travail de programmation locale par Claude Code, pas un export natif Firecrawl. Exemple de demande :

Utilise uniquement les 20 lignes acceptées de la feuille vérifiée pour créer un fichier HTML autonome dans ce dossier privé. Échappe toutes les valeurs visibles, ne transforme en liens que les URL web sources validées et ajoute un filtre textuel et un tri simple. Ne consulte pas d’autres pages, ne devine aucune cellule et n’ajoute aucune dépendance externe. Enregistre le fichier et donne son chemin. Relis-le avant d’annoncer que l’écriture a réussi.

Ouvrez le véritable fichier enregistré dans un navigateur. Vérifiez les 20 entreprises distinctes, le filtre, le tri et l’ouverture des sources sur les bons sites d’entreprise. Comparez tous les champs à la feuille vérifiée, y compris textes longs, caractères inhabituels et valeurs manquantes. En cas d’écart, corrigez feuille ou générateur et rouvrez le fichier. Notez chemin final, empreinte, heure des sources, appels Firecrawl et crédits réels, usage Claude si visible et personnes ayant accès. Marquez les chiffres indisponibles comme inconnus. Un aperçu de chat ou extrait de code ne remplace pas ce contrôle.

En cas d’échec

Si /mcp n’affiche aucun serveur ou renvoie 401, examinez URL enregistrée, portée, équipe et état OAuth, puis reconnectez-vous via /mcp ; le guide de dépannage Firecrawl traite aussi les serveurs en double et le redémarrage de session. Ne collez pas de clé dans le chat. Pour une erreur de recherche ou de lecture, gardez la réponse exacte et distinguez échec et absence de résultats. Vérifiez crédits restants et limites de débit ; un 429 peut signaler une limite. Attendez le délai de reprise autorisé au lieu d’intensifier les appels. Réessayez seulement dans le plafond initial.

Si un site bloque la demande ou n’a pas d’adresse autorisée, notez son rejet. Si l’enregistrement HTML est incertain, inspectez destination et empreinte avant une autre écriture. Si un contrôle ou lien échoue, corrigez depuis la feuille vérifiée et rouvrez le fichier. Arrêtez-vous au document de recherche privé relu. Prospection, écriture CRM ou Google Workspace, surveillance récurrente et actualisation ultérieure demandent chacune leur propre décision et autorité.

Sources et lectures complémentaires