En résumé : Pour générer une liste de prospects avec des agents dans Claude Code, découpez le travail en quatre tâches sur votre tableau : une recherche de profils gratuite avec Apollo via Firecrawl Alexandria, une étape de qualification basée sur les champs déjà renvoyés par cette recherche, un enrichissement payant avec People Data Labs uniquement pour les profils retenus, et une validation humaine avant toute prospection. Une seule clé Firecrawl couvre l'ensemble des fournisseurs, et chaque tâche indique précisément ce qu'elle a consommé.
Il est tout à fait possible de générer une liste de prospects avec des agents au cours d'une seule et longue session Claude Code. Vous demandez les « VP of Engineering de ces dix entreprises, avec leurs adresses e-mail professionnelles », puis l'agent recherche, enrichit et vous renvoie un fichier CSV. Les ennuis commencent au moment de payer la facture : l'agent a payé pour enrichir des profils que vous auriez écartés rien qu'à la lecture de leur intitulé de poste.
Firecrawl Alexandria permet d'appliquer facilement une logique privilégiant les étapes gratuites ou peu coûteuses. La plateforme regroupe des centaines de fournisseurs de données derrière une unique clé d'API Firecrawl, avec un principe clair : la découverte est gratuite, tandis que l'exécution coûte les crédits indiqués pour chaque outil. Cet article détaille ce pipeline sous forme de tâches dans Sharkly, en utilisant Claude Code ou Codex comme environnement d'exécution, et expose le coût en crédits de chaque étape.
Ce que Firecrawl Alexandria apporte à un agent de prospection
Firecrawl Alexandria est une bibliothèque de fournisseurs de données qu'un agent peut interroger via une seule clé Firecrawl. La page d'Alexandria recense 430 fournisseurs et 2 461 fonctionnalités. Un agent découvre un outil gratuitement, consulte ses paramètres d'entrée ainsi que son tarif, puis l'exécute via le même point de terminaison scrape que celui utilisé pour les pages web.
Pour la constitution de listes de prospects, c'est la catégorie People qui prime. Elle regroupe 12 fournisseurs, dont Apollo, People Data Labs, FullEnrich et Data Legion pour l'enrichissement, ainsi que des sources publiques comme les listes de sanctions ou le registre NPI. Cet article s'appuie sur deux d'entre eux :
| Fournisseur | Fonctionnalité | Tarif affiché | Rôle dans le pipeline |
|---|---|---|---|
| Apollo | people/search |
0 crédit | Trouver des profils par intitulé de poste sur vos domaines cibles |
| People Data Labs | person/enrich |
60 crédits par appel | Compléter les champs du profil uniquement pour les profils qualifiés |
La page dédiée à Apollo sur Alexandria propose une compétence intégrée intitulée « Search-first prospect list ». Sa description résume toute la stratégie en une phrase : chercher gratuitement d'abord, ne révéler que les profils qui justifient un coût, puis récupérer les adresses e-mail professionnelles vérifiées par ordre de coût croissant. Le tableau ci-dessous convertit ce principe en quatre tâches dotées de responsables attitrés.
Pourquoi une liste de prospects nécessite des étapes et non un prompt unique
Une session unique masque l'arbitrage qui détermine le coût global : qui est écarté avant l'appel payant. La grille tarifaire de Firecrawl illustre clairement cet écart.
Supposons qu'Apollo renvoie 40 personnes réparties sur vos dix domaines cibles. Les enrichir toutes à raison de 60 crédits par profil coûterait 2 400 crédits, soit plus du double des 1 000 crédits mensuels du forfait gratuit (Free). Si une passe de qualification sur les intitulés de poste n'en conserve que 12, l'enrichissement ne coûte plus que 720 crédits et reste dans les limites du forfait gratuit.
Cette règle d'exclusion relève d'une décision métier. C'est à une personne de déterminer si un poste comme « Head of Platform » correspond à un acheteur potentiel. Si ce critère est enfoui dans un prompt, personne ne le vérifie. En revanche, s'il fait l'objet d'une tâche assignée, il dispose d'un responsable, d'un statut et d'un historique des modifications.
Générer une liste de prospects avec des agents : les quatre tâches
Voici la décomposition du pipeline en tâches sur votre tableau. Reliez-les avec la dépendance bloque / est bloqué par afin que chaque étape attende la fin de la précédente.
| Tâche | Responsable | Coût Firecrawl | Critère d'achèvement |
|---|---|---|---|
| 1. Conversion de l'ICP en filtres Apollo + recherche de personnes | Agent | 0 crédit | Liste de profils enregistrée, nombre de lignes publié |
| 2. Qualification sur les champs renvoyés | Agent | 0 crédit | Profils retenus et motifs d'exclusion publiés |
| 3. Enrichissement des profils retenus via People Data Labs | Agent | 60 crédits par appel | Lignes enrichies publiées, crédits dépensés renseignés |
| 4. Révision avant prospection | Humain | 0 crédit | Liste approuvée, modifiée ou renvoyée |
Étape 1 : Traduire l'ICP en recherche Apollo gratuite
La première tâche consiste à convertir votre profil client idéal (ICP) en paramètres de recherche Apollo. Cette fonctionnalité accepte person_titles, q_keywords, q_organization_domains_list, page et per_page, avec un maximum de 100 résultats par page. Le playground d'Apollo indique un coût de 0 crédit pour cet appel.
La découverte d'outils est également gratuite. Si l'agent ignore quel outil employer, il interroge Alexandria avec sources: ["alexandria"]. La documentation de Firecrawl précise que l'ajout de "web" aux sources renvoie également des résultats web payants ; veillez donc à limiter la découverte aux seuls outils.
# Free tool discovery: tools only, no paid web results
curl https://api.firecrawl.dev/v2/search \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "find people by job title at a company", "sources": ["alexandria"], "limit": 3}'
# Apollo people search at the target domains (listed at 0 credits)
curl https://api.firecrawl.dev/v2/scrape \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"alexandria": {
"provider": "apollo",
"capability": "people/search",
"options": {
"person_titles": ["VP of Engineering", "Head of Platform"],
"q_organization_domains_list": ["example-one.com", "example-two.com"],
"page": 1,
"per_page": 100
}
}
}'
Le résultat se trouve sous alexandria[0].data. La documentation de Firecrawl recommande de vérifier l'absence d'erreurs dans le retour de chaque outil avant de l'exploiter. Intégrez donc cette règle aux critères d'acceptation : la tâche n'est terminée que lorsque l'agent a publié le nombre de lignes obtenues et les éventuelles erreurs rencontrées.
Étape 2 : Qualifier à partir des champs déjà renvoyés par la recherche
L'étape de qualification ne coûte rien. Elle analyse les résultats de la recherche et élimine les lignes d'après les données déjà recueillies : intitulé inadapté, entreprise hors cible, doublon. Aucun nouvel appel n'est émis.
Définissez les règles d'exclusion là où chaque agent pourra les lire. Une compétence (Skill) Sharkly regroupe des instructions réutilisables pour le travail des agents ; ces règles deviennent ainsi une compétence associée à chaque agent chargé de la prospection, comme expliqué dans Skills in Sharkly.
# lead-rules.md (owner: the person who approves the send)
keep_titles: ["VP of Engineering", "Head of Platform", "Director of Engineering"]
drop_if: [title_not_in_keep_titles, company_domain_not_in_list, duplicate_person]
max_enrich_calls_per_run: 15
pdl_min_likelihood: 6
every_task_reports: [rows_in, rows_out, credits_spent, errors]
Étape 3 : N'enrichir que les profils retenus
C'est l'étape payante. La fonctionnalité person/enrich de People Data Labs est affichée à 60 crédits par appel. Elle accepte comme identifiant suffisant un pdl_id, un email ou un email_hash, ainsi que 18 autres champs facultatifs. Demandez à l'agent de consulter l'ensemble des paramètres attendus via findTools avant de faire correspondre les champs de la recherche avec les entrées d'enrichissement.
Le paramètre le plus économique est min_likelihood. Compris entre 1 et 10, sa valeur par défaut est de 2, niveau auquel Firecrawl estime qu'une correspondance n'a que 10 à 30 % de chances de désigner la bonne personne. Augmenter ce seuil transforme une correspondance incertaine en erreur 404, et la documentation du fournisseur en explique clairement l'avantage : « ici, une 404 est gratuite, alors qu'un mauvais enregistrement est facturé ».
// One enrich call per qualified person; client set up with $FIRECRAWL_API_KEY
const result = await firecrawl.scrape({
alexandria: {
provider: "people-data-labs",
capability: "person/enrich",
options: {
email: person.email, // or pdl_id / email_hash
min_likelihood: 6, // weak matches 404 instead of billing a wrong record
titlecase: true,
},
},
});
const record = result.alexandria[0];
if (record.error) report.errors.push(record.error);
People Data Labs applique également un quota via Alexandria : 50 000 appels d'API par an et par organisation cliente, partagés entre les points de terminaison pour les personnes et les entreprises. Les nouvelles tentatives sont décomptées, et le quota se réinitialise le 1er janvier UTC. C'est une raison supplémentaire de plafonner les appels d'enrichissement par exécution dans votre fichier de règles.
Si un appel échoue avec l'erreur THIRD_PARTY_DATA_TERMS_REQUIRED, la réponse contient une requiresAction.url. Un administrateur de l'organisation doit y accepter les conditions d'utilisation du fournisseur, la documentation de Firecrawl précisant que les agents doivent obtenir une autorisation explicite de l'utilisateur avant d'accepter des conditions. Traitez ce cas comme un passage de relais : l'agent place la tâche en attente d'une réponse humaine.
Étape 4 : Un humain valide avant toute prospection
La dernière tâche revient à un être humain. L'agent joint la liste enrichie et place la tâche en attente de révision humaine. Le réviseur vérifie un échantillon par rapport aux profils publics, retire les personnes à ne pas contacter et valide la liste.
Il s'agit du même point de contrôle que celui présenté dans notre article sur les agents de développement avec intervention humaine (human-in-the-loop). La liste n'est que de la donnée ; contacter une personne est une décision qui doit être validée par un humain.
Le décompte des crédits par étape
Pour 10 domaines cibles, 40 profils trouvés et 12 qualifiés, les tarifs affichés donnent le décompte suivant :
| Étape | Appels | Crédits |
|---|---|---|
| Découverte d'outils | 1 | 0 |
Apollo people/search |
1 | 0 |
| Qualification | 0 | 0 |
People Data Labs person/enrich |
12 | 720 |
| Total | 14 | 720 |
La conversion des crédits en dollars varie selon l'abonnement : il convient donc de faire le calcul exact plutôt que d'arrondir. D'après la grille tarifaire de Firecrawl en facturation mensuelle, le forfait Hobby s'élève à 19 $ pour 5 000 crédits (soit 0,0038 $ le crédit), ce qui revient à environ 2,74 $ de crédits pour 720 crédits. Le forfait Standard est à 99 $ pour 100 000 crédits (soit 0,00099 $ le crédit), ce qui ramène la même exécution à environ 0,71 $. Quant aux 1 000 crédits mensuels du forfait gratuit, ils couvrent l'opération pour 0 $.
Sans cette étape de qualification, la même exécution consommerait 2 400 crédits : soit environ 9,12 $ avec l'offre Hobby, et bien plus que le plafond du forfait gratuit. L'étape de qualification est la ligne la moins chère du récapitulatif, mais c'est elle qui génère le plus d'économies.
Comment Sharkly garantit la rigueur du pipeline
Claude Code ou Codex effectue les appels. Sharkly structure et supervise l'ensemble du processus.
- Des tâches assignées. Chaque étape dispose d'un statut et d'un responsable, qu'il s'agisse d'un agent, d'une équipe (Crew) ou d'une personne physique.
- La clé API reste hors du descriptif des tâches. Renseignez
FIRECRAWL_API_KEYdans les variables d'environnement de l'agent (sous Computer & Runtime) : elle est alors injectée au lancement du processus de l'agent. Sharkly désignant ces valeurs comme des paramètres en texte brut visibles par les gestionnaires d'agents (et non comme un coffre-fort de secrets), veillez à utiliser une clé restreinte à cet usage. - Des statuts de révision. Un agent peut mettre une tâche en attente d'une réponse ou d'une validation humaine, qui arrive directement dans la boîte de réception de la personne concernée.
- L'historique des exécutions. Chaque session consigne son début, sa fin, les appels d'outils et le détail des erreurs, assurant ainsi la traçabilité complète de la consommation de crédits.
Si vous préférez ne pas créer ces quatre tâches manuellement, un chef d'équipe (Crew leader) peut décomposer une tâche parente en différentes étapes, comme expliqué dans Sharkly Crews. Vous pouvez commencer à utiliser Sharkly gratuitement, et la consommation de modèles est facturée sur le forfait Claude Code ou Codex associé à votre environnement d'exécution (Runtime).
Planifier l'exécution, tout en conservant une révision manuelle
Dès lors que les quatre tâches s'exécutent sans accroc pendant une semaine, associez les tâches 1 à 3 à une automatisation afin que chaque nouvelle liste de domaines déclenche la recherche gratuite et l'enrichissement plafonné. La tâche 4 demeure manuelle. Pour surveiller plusieurs de ces exécutions en parallèle, consultez how to monitor coding agents running in parallel.
Commencer par les étapes gratuites
Générez votre liste de prospects avec des agents selon la méthodologie préconisée par Apollo : effectuez d'abord une recherche gratuite, qualifiez avec les données déjà disponibles, ne payez que pour les profils retenus et faites valider la liste par une personne avant toute prise de contact. Commencez par les tâches 1 et 2 dans Sharkly. Elles coûtent 0 crédit et vous indiquent précisément ce que coûterait l'étape payante.
FAQ
Qu'est-ce que Firecrawl Alexandria ?
Une bibliothèque de fournisseurs de données que les agents peuvent interroger à l'aide d'une seule clé d'API Firecrawl. La découverte est gratuite, et chaque outil affiche son propre tarif en crédits pour l'exécution. Firecrawl l'a lancée le 22 septembre 2026.
La recherche de personnes Apollo est-elle gratuite via Firecrawl ?
La fonctionnalité people/search d'Apollo affiche 0 crédit dans le playground de Firecrawl. L'accès aux coordonnées de contact constitue en revanche une étape distincte et payante ; pensez donc à vérifier le tarif affiché pour cette fonctionnalité avant de l'exécuter.
Combien coûte l'enrichissement People Data Labs sur Firecrawl ?
La fonctionnalité person/enrich est affichée à 60 crédits par appel. Cela représente environ 0,23 $ avec le forfait Hobby et 0,06 $ avec Standard, en facturation mensuelle. Une erreur 404 consécutive au relèvement de min_likelihood ne coûte rien.
Cela fonctionne-t-il avec Codex au lieu de Claude Code ?
Oui. Firecrawl propose une interface en ligne de commande (CLI), des SDK et un serveur MCP intégrant firecrawl_search, firecrawl_find_tools et firecrawl_scrape, et un agent Sharkly peut fonctionner indifféremment sur l'un ou l'autre de ces environnements d'exécution. La configuration globale est détaillée dans AI task manager: assign, track, and review agent work.
Un agent doit-il envoyer des messages de prospection de manière autonome à partir de la liste ?
Non. L'envoi doit impérativement être précédé d'une tâche de validation humaine. Le rôle de l'agent s'arrête à la livraison d'une liste vérifiée et d'un récapitulatif des crédits consommés.
