# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Nature du dépôt

Ce n'est **pas** un projet de code : c'est un **espace de recherche de mots-clés SEO** pour **Acieb énergie**, un **courtier en énergie B2B** opérant en **France (national)**. Aucun build, test ou lint. Le « livrable » est constitué de listes de mots-clés (CSV) accompagnées de briefs (Markdown).

Langue de travail : **français uniquement**.

## Modèle mental

Acieb vend un **service de courtage en énergie** (électricité + gaz) à des **entreprises énergivores**. La recherche de mots-clés est donc organisée selon **deux axes transverses** :

- **Par thématique sectorielle** → `02-thematiques-sectorielles/<secteur>/` (les clients : boulangerie, hôtel, restaurant…)
- **Par concurrent** → `05-concurrents/<courtier>/` (les autres courtiers FR : Opéra Énergie, Capitole Énergie…)

Les autres dossiers (`01`, `03`, `04`, `06`, `07`, `08`) découpent par **cœur de métier, type d'énergie, intention, réglementaire, longue traîne et marque**.

`09-mangools-bulk/` est le **sas d'export vers Mangools** : des listes plates `.txt` (1 mot-clé/ligne, lots ≤ 100, groupés par catégorie) générées depuis les `mots-cles.csv`, prêtes à coller dans KWFinder/SERPChecker. Les exports rapatriés (volume/KD/CPC) servent à remplir les colonnes `volume`/`difficulte` des CSV sources. Voir `09-mangools-bulk/README.md`. Ne pas éditer les `.txt` à la main : les régénérer depuis les sources.

## Convention CSV (à respecter strictement)

Tous les fichiers `*.csv` partagent **le même en-tête**, dans cet ordre exact :

```
mot_cle,volume,difficulte,intention,secteur,energie,priorite,statut,notes
```

- `volume` : volume de recherche mensuel (entier, ou vide si inconnu)
- `difficulte` : 0-100 (KD Ahrefs/Semrush, ou vide)
- `intention` : `info` | `commercial` | `transactionnel` | `marque`
- `secteur` : slug du secteur (`boulangerie`, `hotellerie`…) ou `transverse`
- `energie` : `electricite` | `gaz` | `multi` | `na`
- `priorite` : `1` (haute) | `2` | `3`
- `statut` : `a_faire` | `valide` | `publie`
- `notes` : texte libre (mettre entre guillemets si virgule)

Séparateur : **virgule**. Encodage : **UTF-8**. Ne pas réordonner ni renommer les colonnes.

## Règles de contribution

- **Créer un nouveau secteur** : dupliquer `02-thematiques-sectorielles/_modele-secteur/` → le renommer (slug en kebab-case, sans accent) → remplir `brief.md` puis `mots-cles.csv`.
- **Créer un nouveau concurrent** : dupliquer `05-concurrents/_modele-concurrent/` → renseigner `analyse.md` + `mots-cles.csv`. Mettre à jour `05-concurrents/_liste-concurrents.md`.
- **Dédupliquer** : `_exports/` contient les listes consolidées finales (union de tous les CSV, dédupliquée sur `mot_cle`). Ne jamais éditer un export à la main — il se régénère depuis les sources.
- Les dossiers/fichiers préfixés `_` sont des **gabarits ou index**, pas des données réelles.

## Outils suggérés

Données de volume/difficulté : Ahrefs, Semrush, ou Google Keyword Planner. Scraping de SERP concurrentes : instance Firecrawl self-hosted (cf. règles globales). Pour la production de pages SEO à partir de ces listes, le skill `seo-eeat` et `seo-geo` sont disponibles.