Files

ML Engineer ed07c8a3d1 Initial commit: existing turf_saas codebase

Co-Authored-By: Paperclip <noreply@paperclip.ing>

2026-04-25 17:18:43 +02:00

5.0 KiB

Executable File

Raw Blame History

🏢 H3R7Tech - Workflow Extraction Artisans

📋 Résumé

Ce workflow permet d'extraire les coordonnées des artisans d'une ville précise depuis les annuaires professionnels et de les intégrer dans un CRM.

🏗️ Architecture de la Solution

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   EXTRACTION    │────▶│    STOCKAGE     │────▶│      CRM        │
│                 │     │                 │     │                 │
│ • Pages Jaunes  │     │ • Fichier JSON  │     │ • Suivi statut │
│ • Google Maps   │     │ • Export CSV    │     │ • Scoring      │
│ • Google Search │     │ • Google Sheets │     │ • Relances     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

🔧 Méthodes d'Extraction (Gratuites)

Option 1: Script Python (Ce projet)

python3 scraper_artisans.py --profession "cordonnier" --ville "lille" --cp "59000"

Option 2: Extension Chrome "Web Scraper"

Installer l'extension "Web Scraper" sur Chrome
Créer un sitemap pour PagesJaunes
Exporter les données en CSV
Importer dans le CRM

Option 3: Google Sheets + ImportXML

=IMPORTXML("https://www.pagesjaunes.fr/annuaire/lille-59000/cordonnier", "//div[@class='bi-thu__ItemSearchResult']")

📊 Données Extraites

Champ	Description	Exemple
Nom	Nom de l'artisan	Dupont Philippe
Entreprise	Nom de l'entreprise	Dupont Cordonnerie
Activité	Métier	Cordonnier
Adresse	Adresse complète	45 Rue Nationale, Lille 59000
Téléphone	Numéro	0320123456
Site web	URL	www.dupont-cordonnerie.fr
Note	Note Google	4.5
Avis	Nombre d'avis	120

💾 Stockage

Format JSON (CRM local)

{
  "prospects": [
    {
      "id": 1,
      "nom": "Dupont Philippe",
      "entreprise": "Dupont Cordonnerie",
      "tel": "0320123456",
      "secteur": "Cordonnier",
      "statut": "nouveau",
      "score": 4,
      "notes": "Adresse: 45 Rue Nationale...",
      "source": "Scraping",
      "created": "2026-02-25T20:42:00"
    }
  ]
}

Export CSV (pour Google Sheets)

Le script génère un fichier CSV compatible Google Sheets:

exports/prospects_20260225_204200.csv

📊 CRM - Suivi des Contacts

Statuts de suivi

Statut	Description	Action
🔵 Nouveau	Prospect nouvellement ajouté	À appeler
🟡 Qualifié	Besoin identifié	Proposition
🟣 Proposition	Devis envoyé	En attente
🟢 Gagné	Client acquis	Suivi SAV
🔴 Perdu	Pas de réponse	À relancer

Score de qualification (1-5)

Score	Critères
⭐	Nom uniquement
⭐⭐	+ Téléphone
⭐⭐⭐	+ Note/avis
⭐⭐⭐⭐	+ Site web
⭐⭐⭐⭐⭐	Complete

🚀 Utilisation

1. Lancer le scraper

python3 scraper_artisans.py --profession "cordonnier" --ville "lille" --cp "59000"

2. Ajouter manuellement

Via l'interface: http://178.18.250.53:8765/scraper_pro.html

3. Exporter vers Google Sheets

1.Exporter en CSV depuis le CRM 2.Importer dans Google Sheets 3.Configurer les filtres

📱 Intégrations Gratuites Recommandées

CRM Gratuits

Service	Limite gratuite	Features
HubSpot Free	1 user, 1M contacts	Complet
Airtable	1,000 rows	Base + Views
Notion	Illimité	Database
Google Sheets	Illimité	+ ImportXML

Google Sheets - Configuration

Créer un nouveau Sheet
Importer le CSV exporté
Créer des vues filtrées par statut
Ajouter des validations de données

⚠️ Limitations Techniques

PagesJaunes / Google Maps

Bloquent les requêtes automatisées
Cloudflare active des CAPTCHA
Solution: Utiliser un navigateur headless (Playwright) avec stealth mode

Alternatives

APIfy: Service payants avec proxy rotatif
ScraperAPI: Crédits gratuits disponibles
Manual: Ajout manuel via l'interface

📁 Fichiers du Projet

/home/h3r7/turf_scraper/
├── scraper_artisans.py    # Script principal
├── crm_prospects.json    # Base CRM
├── exports/              # Exports CSV
│   └── prospects_*.csv
└── scraper_pro.html      # Interface web

🎯 Checklist de Qualification

Téléphone disponible → Appeler
Note > 4.0 → Priorité haute
Avis > 50 → Qualité confirmée
Site web → Demander un devis en ligne
Dans la zone → Visite commerciale

📞 Scripts de Prospection

Voir le document: SCRIPTS_DEMARCHAGE.html

Document généré le 25/02/2026 - H3R7Tech

5.0 KiB Executable File Raw Blame History