Communitygithub.com

aiagentwithdhruv/skills

Récupérez et vérifiez des prospects commerciaux avec Apify, classez-les avec un LLM, enrichissez les e-mails et sauvegardez dans Google Sheets. Utilisez-le lorsque l'utilisateur demande de trouver des prospects, de gratter des entreprises, de générer des listes de prospects ou de construire des bases de données de leads pour n'importe quel secteur ou localisation.

Qu'est-ce que skills ?

Cette compétence permet de gratter des prospects (leads) via Apify (acteur `code_crafter/leads-finder`), de vérifier leur pertinence (correspondance sectorielle > 80 %) et de les enregistrer dans une feuille Google Sheets. Elle est conçue pour les agents IA qui travaillent avec des outils de développement comme Claude Code, Cursor ou Codex, afin d'automatiser la prospection B2B. Pour les gros volumes (1000+ leads), elle utilise un scraping parallèle avec partitionnement géographique (États-Unis, Europe, Royaume-Uni, Canada, Australie), offrant des performances 3 à 5 fois supérieures. Elle inclut également une classification optionnelle via LLM pour les niches complexes, un enrichissement des e-mails avec AnyMailFinder, et une mise à jour par lots de la feuille Google. Les utilisateurs doivent configurer les clés API dans un fichier `.env`.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/scrape-leads

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Récupération et vérification de prospects

Objectif

Récupérer des prospects avec Apify (code_crafter/leads-finder), vérifier leur pertinence (correspondance sectorielle > 80 %) et les enregistrer dans une feuille Google Sheets. Pour les gros volumes (1000+ prospects), utiliser un scraping parallèle pour des performances 3 à 5 fois plus rapides.

Entrées

  • Secteur d'activité : Le secteur cible (ex. "Plombiers", "Agences logicielles")
  • Localisation : La localisation cible (ex. "Texas", "États-Unis", "Californie"). Les scripts mettent automatiquement au format requis par Apify (les états américains reçoivent le suffixe ", us" automatiquement).
  • Nombre total : Le nombre total de prospects souhaité

Scripts

Tous les scripts se trouvent dans ./scripts/ :

  • scrape_apify.py - Récupération unique, pour <1000 prospects
  • scrape_apify_parallel.py - Récupération parallèle, pour 1000+ prospects
  • classify_leads_llm.py - Classification des prospects basée sur LLM
  • enrich_emails.py - Enrichissement des e-mails via AnyMailFinder
  • update_sheet.py - Mise à jour par lots de la feuille
  • read_sheet.py - Lecture des données depuis Google Sheets

Processus

Petites récupérations (<1000 prospects)

  1. Récupération test

    python3 ./scripts/scrape_apify.py --query "SECTEUR" --location "LOCALISATION" --max_items 25 --no-email-filter --output .tmp/test_leads.json
    
  2. Vérification

    • Lire .tmp/test_leads.json
    • Vérifier qu'au moins 20/25 (80 %) des prospects correspondent au secteur
    • Réussi : Passer à l'étape 3
    • Échoué : Arrêter et demander à l'utilisateur d'affiner les mots-clés
  3. Récupération complète

    python3 ./scripts/scrape_apify.py --query "SECTEUR" --location "LOCALISATION" --max_items NOMBRE_TOTAL --no-email-filter --output .tmp/leads.json
    
  4. [Optionnel] Classification LLM (pour les niches complexes)

    python3 ./scripts/classify_leads_llm.py .tmp/leads.json --classification_type product_saas --output .tmp/classified_leads.json
    
  5. Téléchargement vers Google Sheets

    python3 ./scripts/update_sheet.py .tmp/leads.json --title "Prospects - SECTEUR"
    
  6. Enrichissement des e-mails manquants

    python3 ./scripts/enrich_emails.py URL_FEUILLE
    

Grandes récupérations (1000+ prospects)

  1. Récupération test (identique à ci-dessus avec 25 éléments)

  2. Récupération complète parallèle

    python3 ./scripts/scrape_apify_parallel.py \
      --query "SECTEUR" \
      --total_count 4000 \
      --location "États-Unis" \
      --strategy regions \
      --no-email-filter
    

    Le partitionnement géographique est automatique :

    • États-Unis : 4 zones (Nord-Est, Sud-Est, Midwest, Ouest)
    • UE/Europe : 4 zones (Ouest, Sud, Nord, Est)
    • Royaume-Uni : 4 zones (SE Angleterre, N Angleterre, Écosse/Pays de Galles, SO Angleterre)
    • Canada : 4 zones (Ontario, Québec, Ouest, Atlantique)
    • Australie : 4 zones (NSW, VIC/TAS, QLD, WA/SA)
  3. Continuer avec les étapes 4 à 6 des petites récupérations

Résultats

Le seul livrable est l'URL de la feuille Google Sheets. Les fichiers JSON locaux dans .tmp/ sont des intermédiaires temporaires.

Cas particuliers

  • Aucun prospect trouvé : Demander à l'utilisateur d'élargir la recherche
  • Erreur API : Vérifier les identifiants dans .env
  • Classifications de faible qualité : Si >80 % "peu clair", améliorer les mots-clés de récupération

Environnement

Nécessite dans .env :

APIFY_API_TOKEN=votre_token
GOOGLE_APPLICATION_CREDENTIALS=chemin/vers/credentials.json
ANTHROPIC_API_KEY=votre_clé
ANYMAILFINDER_API_KEY=votre_clé

Schéma

Entrées

NomTypeRequisDescription
industrychaîneOuiSecteur cible (ex. 'Plombiers', 'Agences logicielles')
locationchaîneOuiLocalisation cible (ex. 'Texas', 'États-Unis')
total_countentierOuiNombre total de prospects souhaité
classification_typechaîneNonType de classification LLM (ex. 'product_saas')

Sorties

NomTypeDescription
sheet_urlchaîneURL de la feuille Google avec les prospects récupérés
lead_countentierNombre de prospects trouvés

Identifiants

NomSource
APIFY_API_TOKEN.env
GOOGLE_APPLICATION_CREDENTIALS.env
ANTHROPIC_API_KEY.env
ANYMAILFINDER_API_KEY.env

Compatible avec

Compétences qui s'enchaînent bien avec celle-ci : classify-leads, casualize-names, instantly-campaigns, onboarding-kickoff

Coût

0,01 à 0,02 $ par prospect + 0,30 $/1K pour la classification

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

aiagentwithdhruv/skills

Add new Modal webhooks for event-driven execution. Use when user asks to create a webhook, add an endpoint, or set up event triggers.

aiagentwithdhruv/skills

Answer Euron Gen AI Bootcamp doubts instantly. Covers Euri API setup across all frameworks (Python, LangChain, OpenAI SDK, TypeScript, n8n, curl), MCP server setup, common errors, model recommendations, and token limits. Use when someone in the bootcamp asks a question.

aiagentwithdhruv/skills

Manage emails across multiple Gmail accounts with unified tooling. Use when user asks to check email, read inbox, label emails, archive messages, or manage Gmail across accounts.

aiagentwithdhruv/skills

Auto-label Gmail emails into Action Required, Waiting On, and Reference categories. Use when user asks to label emails, triage inbox, categorize emails, or organize Gmail.

aiagentwithdhruv/skills

Scrape Google Maps for B2B leads with deep website enrichment and contact extraction. Use when user asks to find local businesses, scrape Google Maps, generate contractor lists, or build local service business databases.

aiagentwithdhruv/skills

Run Claude orchestrator locally with Cloudflare tunneling. Use when user asks to run locally, start local server, or test webhooks locally.

aiagentwithdhruv/skills

MCP server for AI-powered macOS control — apps, display, audio, files, screenshots, clipboard

aiagentwithdhruv/skills

Deploy execution scripts to Modal cloud. Use when user asks to deploy to Modal, push code to cloud, or update Modal functions.

aiagentwithdhruv/skills

Query Skool community content using RAG pipeline with vector search. Use when user asks to search Skool knowledge, find community answers, or query Skool content.

aiagentwithdhruv/skills

Scrape Upwork jobs and generate personalized proposals with cover letters. Use when user asks to find Upwork jobs, create Upwork proposals, or apply to Upwork listings.

Skills associés