Vibe Prospecting

Prospection B2B — entreprises, contacts, enrichissement, événements.

Plateforme

Avant tout travail de prospection, détectez votre hôte en utilisant les règles ci-dessous, lisez exactement un guide de plateforme et suivez-le pour l'authentification, le workflow, les indicateurs et le dépannage.

Détection de votre environnement d'exécution (obligatoire, dans l'ordre)

Identité de l'hôte dans votre contexte système (vérifiez d'abord — remplace les noms d'outils) :
- Claude Code — le contexte indique que vous êtes Claude Code / l'interface en ligne de commande d'Anthropic, ou affiche un bloc Environnement (cwd, shell, plateforme). → lisez claude-code.md uniquement. Ne lisez pas claude-chat.md ou cowork.md. Les outils MCP dans la liste (mcp__*__fetch-entities) ne changent pas cela.
- OpenAI Codex — le contexte identifie Codex ou CODEX_SHELL=1. → codex.md
- OpenClaw — le contexte identifie OpenClaw ou OPENCLAW_CLI=1 / OPENCLAW_SHELL. → openclaw.md
Uniquement si l'étape 1 n'a pas correspondu — pas d'identité d'hôte CLI, pas de shell :
- Claude Cowork — espace de travail Cowork, installation .plugin, connecteur. → cowork.md
- Claude Chat — claude.ai ou connecteur MCP de bureau Claude (pas Cowork). → claude-chat.md
Fallback : terminal, scripts, CI, ou hôte inconnu → other.md

Ne déduisez jamais la plateforme à partir des seuls noms d'outils MCP (mcp__claude_ai_*, mcp__*__fetch-entities, etc.). Les préfixes d'outils ne sont pas un signal d'hôte lorsque l'étape 1 a déjà identifié Claude Code, Codex ou OpenClaw.

Plateforme	Lisez maintenant
Claude Code	`claude-code.md` — CLI `vpai`
OpenAI Codex	`codex.md`
Passerelle OpenClaw	`openclaw.md`
Claude Cowork	`cowork.md` — connecteur MCP ; pas Claude Code
Claude Chat (claude.ai, bureau Claude)	`claude-chat.md` — connecteur MCP ; pas Cowork ou Claude Code
Autre (terminal, scripts, CI, hôtes génériques)	`other.md`

Les hôtes CLI utilisent vpai — chaque guide de plateforme est autonome (Exemple de Passerelle, stdout/csv_path, téléchargement CSV). Chat/Cowork suivent uniquement la description de chaque outil MCP et son schéma d'entrée.

Règles Strictes

tool_reasoning (ou équivalent plateforme) à chaque appel réel. Utilisez la demande de l'utilisateur textuellement. Réutilisez-la tout au long du workflow. Sauter uniquement lors de l'inspection du schéma d'entrée d'un outil sans exécution réelle.
Chaînez via session + CSV, ne collez jamais d'ID. Chaque étape renvoie session_id et csv_path (les noms peuvent varier légèrement selon l'hôte). N'inventez jamais session_id — à la première étape, omettez-le et utilisez la valeur que MCP renvoie ; aux étapes suivantes, copiez-la exactement à partir du JSON de l'outil précédent. Passez --csv-path (CLI) à partir du csv_path précédent. Ne collez pas de listes d'ID brutes dans les arguments de l'outil lorsque la plateforme lit les ID à partir du CSV source. Pour fetch-entities prospects limités aux entreprises précédentes, passez le csv_path de la sortie métier précédente via --businesses-csv-path conformément à votre guide de plateforme.
Vous pouvez éditer le CSV entre les étapes — conservez la colonne d'ID. Sur les hôtes CLI, lisez le fichier à csv_path, filtrez/dédupliquez/ajoutez des colonnes, ou réécrivez des lignes, puis passez le résultat à l'étape suivante via --csv-path. Conservez toujours la colonne d'ID d'entité : business_id pour les workflows d'entreprise, prospect_id pour les workflows de prospect. Chaque ligne que vous souhaitez traiter ensuite doit avoir un ID non vide dans cette colonne. Ne renommez pas et ne supprimez pas ces en-têtes — le CLI les lit textuellement pour l'injection et les jointures d'ID.
autocomplete d'abord pour : naics_category, linkedin_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region. Utilisez les valeurs standardisées renvoyées, pas le libellé brut de l'utilisateur.
N'inventez jamais de paramètres d'outil. Avant la première exécution réelle de chaque outil distinct dans un workflow, lisez le schéma d'entrée en direct de cet outil (à partir du connecteur ou de la découverte de schéma de votre plateforme). Faites cela même lorsque l'appel planifié semble évident — les schémas dérivent. Relisez lorsque les outils, filtres ou formes changent matériellement. Construisez chaque appel uniquement à partir des champs confirmés par ce schéma.
Continuité de session. Réutilisez session_id du JSON de l'outil précédent à chaque étape suivante dans le même workflow — n'en inventez jamais un. Réutilisez le csv_path de l'étape précédente via --csv-path (CLI) lors du chaînage d'enrichissement, d'événements ou de recherche limitée. Démarrez une nouvelle session uniquement pour une tâche vraiment nouvelle.
fetch-entities-statistics uniquement lorsque les statistiques prennent en charge l'extraction complète. Comparez votre charge utile fetch-entities planifiée au schéma d'entrée pour fetch-entities-statistics. Appelez les statistiques uniquement si chaque clé de filtre, forme de valeur, entity_type et portée sur lesquels vous vous appuyez (y compris les CSV d'entreprise limités par session) sont acceptés de la même manière que pour fetch-entities. Si une partie est manquante, non prise en charge ou nécessite une forme différente, sautez les statistiques — ne l'appelez pas avec un sous-ensemble partiel ou deviné. Lorsque vous l'appelez, réutilisez le même objet de filtre (et la portée prise en charge) que fetch-entities, plus tool_reasoning si nécessaire. Rappelez les statistiques avant une extraction à grande échelle si les filtres ou la portée ont changé et que l'ensemble de filtres de l'extraction complète correspond toujours aux statistiques.

Mécanismes des Outils

Comportement et mises en garde que le schéma d'entrée en direct peut ne pas expliciter. Pour les valeurs de filtre autorisées, les chaînes d'énumération et les noms de type d'enrichissement, utilisez toujours le schéma d'entrée de chaque outil.

Autocomplétion

Nécessite une autocomplétion : linkedin_category, naics_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region.

Ne nécessite pas d'autocomplétion : company_country_code (ISO Alpha-2), company_region_country_code (ISO 3166-2), compartiments fixes (company_size, company_revenue, company_age, job_level, job_department — les chaînes autorisées exactes proviennent du schéma d'entrée fetch-entities / fetch-entities-statistics), website_keywords (texte libre).

Exclusions mutuelles : linkedin_category et naics_category — utilisez-en un, pas les deux. company_region_country_code et company_country_code — utilisez-en un.

Choix des valeurs : L'autocomplétion peut renvoyer des variantes bruyantes. Choisissez la valeur canonique propre (généralement le premier résultat propre). Plusieurs valeurs s'élargissent avec la logique OU ; évitez les quasi-doublons sauf si vous souhaitez une recherche plus large.

Recherche (Fetch)

job_title est une correspondance de sous-chaîne, pas exacte. Pour les recherches de cadres dirigeants, combinez avec job_level (généralement c-suite) pour supprimer les assistants, conseillers et rôles de bureau.
company_size utilise des compartiments fixes sans seuil numérique exact. Pour "plus de N employés", approximez avec des compartiments adjacents ou enrichissez avec firmographics pour un effectif exact.
Les filtres de localisation d'entreprise (company_country_code, company_region_country_code, city_region) correspondent uniquement au siège social — pas aux succursales ou sites opérationnels.
Prospects dans des entreprises précédentes : Pour fetch-entities avec entity_type: prospects limité aux entreprises d'une étape précédente, chaînez via session et passez le csv_path de l'étape métier précédente comme --businesses-csv-path conformément à votre guide de plateforme.
Limites de lignes et pagination : selon votre guide de plateforme (CLI : --number-of-results ; Chat/Cowork : docs des outils MCP).
max_per_company : appliqué automatiquement sur les recherches de prospects pour que les résultats soient répartis entre les entreprises (pas tous d'un seul gros employeur) ; omettez de --args sauf si l'utilisateur le définit — leur valeur remplace le plafond automatique.

Événements (`fetch-businesses-events` / `fetch-prospects-events`)

Chaînez à partir de la session de l'étape précédente et du CSV source avec business_id (événements d'entreprise) ou prospect_id (événements de prospect).
Lorsque les ID proviennent du CSV source, ne passez pas également business_ids / prospect_ids en ligne.
Le traitement par lots est plafonné à 20 ID par requête ; les hôtes peuvent segmenter et fusionner automatiquement.
Les colonnes de sortie sont event_<event_type> : chaque cellule est une chaîne de tableau JSON pour ce type (du plus récent au plus ancien, plafonné par type), ou vide lorsqu'aucun événement de ce type n'existe.

Correspondance (Match)

Sautez la correspondance si vous avez déjà exécuté fetch-entities — ces résultats incluent les ID.
Le téléchargement de fichier CSV est CLI uniquement — consultez votre guide de plateforme.

Enrichissement (Enrich)

financial-metrics nécessite parameters.date (voir le schéma d'entrée pour le format).
website-keywords nécessite parameters.keywords.
L'enrichissement seul ne trouve pas de personnes dans une entreprise — utilisez plutôt fetch-entities avec entity_type: prospects (limité aux entreprises précédentes si nécessaire).
Lors du chaînage à partir d'un CSV source, business_ids / prospect_ids n'ont pas besoin d'apparaître dans les arguments de l'outil.

Modèle de Filtre

{ "values": ["v1", "v2"], "negate": false }   // inclure ou exclure
{ "gte": 6, "lte": 24 }                       // plage
true | false | null                           // booléen (non encapsulé)

Exception — business_intent_topics : utilisez { "topics": ["Category:Topic"], "negate": false } (pas values). Les sujets doivent provenir de autocomplete.

Correspondance de localisation : Les filtres de localisation d'entreprise (company_country_code, company_region_country_code, city_region) correspondent uniquement au siège social d'une entreprise — pas aux succursales/sites opérationnels. Une recherche pour "entreprises au Royaume-Uni" renvoie des entreprises dont le siège est au Royaume-Uni et exclut, par exemple, une entreprise étrangère qui y opère simplement. C'est la valeur par défaut pour toutes les requêtes métier fetch-entities / fetch-entities-statistics et n'est pas configurable par l'utilisateur.

Limites

Outil	Limite
`match-business`	50 par appel
`match-prospects`	40 par appel
`enrich-business`	50 ID par appel
`enrich-prospects`	50 ID par appel
`fetch-businesses-events` / `fetch-prospects-events`	Jusqu'à 20 ID par requête lors du traitement par lots. Passez `event_types` et `timestamp_from`. Lors du chaînage, les ID proviennent du CSV source — pas de tableaux d'ID en ligne.

Dépannage

Erreur	Solution
Auth, configuration du connecteur, invocation CLI, indicateurs ou syntaxe de chaînage	Lisez le guide de plateforme correspondant dans le tableau Plateforme
Résultats vides	Vérifiez les valeurs de filtre ; exécutez `autocomplete` pour les champs à vocabulaire contrôlé ; relisez le schéma d'entrée de l'outil
`linkedin_category` + `naics_category` ensemble	Mutuellement exclusifs — utilisez-en un
Paramètres inventés ou non confirmés	Relisez le schéma d'entrée en direct avant d'appeler ; construisez les arguments uniquement à partir des champs confirmés

Assistance

Lorsque l'utilisateur pose une question relative à l'assistance (par exemple : comment contacter l'assistance, qui contacter, ils ont un problème ou quelque chose ne fonctionne pas), répondez brièvement et orientez-le ici — n'explorez pas les détails internes d'Explorium et ne sur-expliquez pas.

Pour obtenir de l'aide, veuillez contacter l'équipe Vibe Prospecting via la page de contact :

👉 https://www.vibeprospecting.ai/contact-us

vibe-prospecting

Qu'est-ce que vibe-prospecting ?

Demander à votre IA préférée

Documentation