n8n-Agent/README.md

# N8N Agent Consultant Expert

Agent Claude spécialisé en création, optimisation et correction de workflows N8N de haute qualité.

## Caractéristiques

- **1,084 nœuds N8N** supportés (537 core + 547 community)
- **7 skills spécialisées** pour la construction de workflows de production
- **20 outils MCP** pour interagir avec N8N
- **2,709 templates** de workflows avec métadonnées complètes
- **87% de couverture documentaire** officielle
- **5 patterns architecturaux** éprouvés sur 2,653+ templates

## Capacités de l'Agent

### Création de Workflows
- Conception d'architectures scalables et robustes
- Utilisation des patterns éprouvés (Webhook, API, Database, AI, Scheduled)
- Configuration optimale des 525+ nœuds supportés
- Gestion d'erreurs et retry logic professionnels
- Expressions N8N avancées avec variables et fonctions

### Correction et Optimisation
- Diagnostic précis des problèmes (erreurs, performance, logique)
- Validation et auto-sanitization des configurations
- Optimisation des performances et de la fiabilité
- Refactoring selon les meilleures pratiques
- Tests et validation complète

### Expertise Technique
- Maîtrise des expressions `{{}}` et variables ($json, $node, $now, $env)
- Code Nodes JavaScript et Python avec patterns testés
- Intégration APIs tierces avec authentification (OAuth, API Key, Basic)
- 8 types de connexions AI (OpenAI, Anthropic, Gemini, etc.)
- Gestion avancée des données et transformations

## Installation Rapide

1. **Configurez le serveur MCP N8N**
   ```bash
   # Copiez le template
   cp .mcp.json.template .mcp.json

   # Éditez avec vos credentials
   nano .mcp.json
   ```

2. **Installez les skills N8N**
   ```bash
   /plugin install czlonkowski/n8n-skills
   ```

3. **Lancez l'agent**
   ```bash
   claude
   ```

Pour l'installation détaillée, consultez [INSTALLATION.md](INSTALLATION.md).

## Structure du Projet

```
n8n-Agent/
├── Claude.md                # Configuration de l'agent expert N8N
├── README.md                # Ce fichier
├── INSTALLATION.md          # Guide d'installation complet
├── .mcp.json.template       # Template de configuration MCP
├── .env.template            # Template de variables d'environnement
├── .gitignore               # Protection des secrets
└── workflows/               # Vos workflows N8N (optionnel)
```

## Utilisation

### Créer un Nouveau Workflow

```
"Je veux créer un workflow qui :
1. Reçoit des données via webhook
2. Enrichit les données avec une API externe
3. Stocke dans Airtable
4. Envoie une notification Slack"
```

### Corriger un Workflow Existant

```
"Mon workflow ID 123 génère une erreur 'Cannot read property of undefined'.
Peux-tu l'analyser et corriger ?"
```

### Optimiser un Workflow

```
"Ce workflow est lent et consomme beaucoup de ressources.
Peux-tu l'optimiser en utilisant le batch processing ?"
```

## Sécurité

**⚠️ IMPORTANT ⚠️**

- **JAMAIS** éditer directement les workflows de production
- **TOUJOURS** tester dans un environnement de développement
- **TOUJOURS** exporter des backups avant modifications
- **TOUJOURS** valider les changements avant déploiement

## Skills Disponibles

1. **n8n Expression Syntax** - Syntaxe et variables
2. **n8n MCP Tools Expert** - Utilisation optimale des outils
3. **n8n Workflow Patterns** - 5 patterns architecturaux
4. **n8n Validation Expert** - Gestion des erreurs de validation
5. **n8n Node Configuration** - Configuration avancée des nœuds
6. **n8n Code JavaScript** - Patterns JavaScript testés
7. **n8n Code Python** - Code Python avec limitations

## Outils MCP

### Documentation (7 outils)
- Recherche de nœuds et validation
- Documentation des propriétés
- Accès aux templates et configurations

### Gestion N8N (13 outils)
- CRUD workflows
- Activation/désactivation
- Gestion des exécutions
- Import/export
- Gestion des credentials

## Patterns de Workflows

1. **Webhook Processing** - Réception et traitement de webhooks
2. **HTTP API** - Appels API avec retry et error handling
3. **Database** - CRUD et synchronisation de données
4. **AI** - Intégrations IA avec prompts dynamiques
5. **Scheduled** - Tâches planifiées et batch processing

## Configuration Requise

- Node.js
- Claude Code CLI ou Claude Desktop
- Instance N8N (cloud ou self-hosted)
- API Key N8N

## Ressources

- **Documentation N8N** : https://docs.n8n.io
- **N8N MCP Server** : https://github.com/czlonkowski/n8n-mcp
- **N8N Skills** : https://github.com/czlonkowski/n8n-skills
- **Claude Code** : https://claude.com/claude-code

## Support

Pour toute question :
- [INSTALLATION.md](INSTALLATION.md) pour l'installation
- [Claude.md](Claude.md) pour la configuration de l'agent
- Issues : Voir les repos GitHub des composants

## Licence

Les composants utilisés ont leurs propres licences :
- N8N MCP Server : MIT
- N8N Skills : MIT

---

**Créé avec** [Claude Code](https://claude.com/claude-code)