n8n-nodes-hellowork

Un nœud n8n personnalisé pour scraper les offres d'emploi du site HelloWork.

Installation

Installation dans n8n GUI

1. Ouvrez votre interface n8n
2. Allez dans Paramètres > Nœuds communautaires
3. Cliquez sur Installer un nœud communautaire
4. Entrez n8n-nodes-hellowork
5. Cliquez sur Installer

Installation manuelle

npm install n8n-nodes-hellowork

Fonctionnalités

✅ Recherche d'emplois avancée

• Mots-clés multiples
• Filtrage par localisation
• Types de contrat (CDI, CDD, Stage, etc.)
• Niveau d'expérience
• Rayon de recherche
• Salaire minimum
• Options de télétravail

✅ Scraping robuste

• Gestion automatique du navigateur
• Retry automatique en cas d'échec
• Respect des délais pour éviter les blocages
• Support multi-pages

✅ Données structurées

• Titre du poste
• Nom de l'entreprise
• Localisation
• Salaire (si disponible)
• Type de contrat
• URL de l'offre
• Métadonnées de scraping

Utilisation

Configuration de base

1. Ajoutez le nœud HelloWork à votre workflow
2. Configurez les paramètres de recherche :
   • Mots-clés : développeur, javascript, react
   • Localisation : Paris
   • Type de contrat : Sélectionnez CDI, CDD, etc.
   • Pages maximum : 3 (recommandé)

Exemple de workflow

Manual Trigger → HelloWork → Process Job Data

Paramètres disponibles

Paramètre	Type	Description	Exemple
Mots-clés	String	Mots-clés de recherche	développeur, react, frontend
Localisation	String	Ville ou région	Paris, Lyon, Marseille
Type de contrat	Multi-Options	Types de contrat	CDI, CDD
Niveau d'expérience	Options	Niveau souhaité	confirmé
Rayon de recherche	Options	Distance en km	20 km
Salaire minimum	Number	Salaire minimum en €	35000
Télétravail	Multi-Options	Options télétravail	Complet, Partiel
Pages maximum	Number	Nombre de pages à scraper	3
Délai entre pages	Number	Délai en ms	3000

Données de sortie

Chaque emploi trouvé contient :

{
  "id": "job-123456",
  "title": "Développeur Frontend React",
  "company": "TechCorp",
  "location": "Paris",
  "salary": "40k-50k €",
  "contractType": "CDI",
  "url": "https://www.hellowork.com/fr-fr/emplois/...",
  "scrapedAt": "2024-01-15T10:30:00.000Z",
  "_metadata": {
    "totalJobs": 25,
    "pagesScraped": 3,
    "executionTime": 15000,
    "errors": [],
    "searchOptions": {...}
  }
}

Bonnes pratiques

Respect du site

• ⚠️ Délais recommandés : Minimum 3 secondes entre les pages
• ⚠️ Limite de pages : Maximum 5 pages par requête
• ⚠️ Fréquence : Évitez les scraping trop fréquents

Optimisation

• 🔄 Utilisez des filtres précis pour réduire le nombre de résultats
• 🔄 Planifiez vos scraping aux heures creuses
• 🔄 Stockez les résultats pour éviter les re-scraping

Gestion d'erreurs

• 📊 Vérifiez les métadonnées pour détecter les erreurs
• 📊 Implémentez des retry en cas d'échec
• 📊 Loggez les erreurs pour le debug

Exemples de workflows

1. Veille emploi automatique

Schedule Trigger (daily) → HelloWork → Filter by salary → Send Email

2. Analyse du marché

Manual Trigger → HelloWork → Aggregate data → Generate report → Save to Google Sheets

3. Notification Slack

Schedule Trigger → HelloWork → Filter new jobs → Format message → Slack

Prérequis

• n8n version : 0.220.0 ou supérieure
• Chrome/Chromium : Installé sur le système
• Node.js : Version 16 ou supérieure

Installation de Chrome

macOS

brew install chromium

Ubuntu/Debian

sudo apt-get install chromium-browser

Docker

RUN apt-get update && apt-get install -y chromium-browser

Dépannage

Erreurs courantes

"Impossible d'initialiser le navigateur"

• Vérifiez que Chrome/Chromium est installé
• Vérifiez les permissions d'exécution

"Timeout waiting for selector"

• Augmentez le délai entre pages
• Vérifiez que le site est accessible

"Aucun emploi trouvé"

• Vérifiez vos critères de recherche
• Testez avec des mots-clés plus génériques

Mode debug

Pour activer les logs détaillés, modifiez les variables d'environnement n8n :

N8N_LOG_LEVEL=debug

Support

• 🐛 Issues : GitHub Issues
• 💬 Discussions : n8n Community Forum
• 📚 Documentation : n8n Docs

Licence

MIT - Voir le fichier LICENSE pour plus de détails.

Avertissement légal

Ce nœud est destiné à un usage éducatif et de recherche. Respectez les conditions d'utilisation de HelloWork et les bonnes pratiques de scraping web. L'utilisateur est responsable de l'utilisation conforme de cet outil.