docs: ecriture naturelle + acces Firecrawl sur les 4 instances Hermes

_INDEX.md

@@ -35,6 +35,7 @@
 
 | Runbook | Date | Tags |
 |---------|------|------|
+| [Écriture naturelle + accès Firecrawl sur les 4 instances Hermes (TT/Nyora/Perso/Nabil)](common/ecriture-naturelle-firecrawl-4-instances.md) | 2026-07-19 | hermes, soul-md, firecrawl, ecriture |
 | [Telegram duplication (flood control overflow-split) + Gitea auth (GITEA_DEPLOY_TOKEN)](common/telegram-flood-control-overflow-split-et-gitea-deploy-token.md) | 2026-07-16 | telegram, gitea, git, hermes |
 | [Fragilités de dépendances stack 43 containers](common/fragilites-dependances-stack-20260703.md) | 2026-07-03 | stack, restart, couplage |
 | [Correctifs fragilités appliqués (rla-api, n8n, bifrost-proxy)](common/correctifs-fragilites-application-20260704.md) | 2026-07-04 | correctifs, healthcheck |

common/ecriture-naturelle-firecrawl-4-instances.md

@@ -0,0 +1,56 @@
+# Écriture naturelle + accès Firecrawl sur les 4 instances Hermes (19/07/2026)
+
+## Contexte
+Nabil a demandé d'appliquer deux choses à hermes-tt, hermes-nyora, hermes-perso (NAS)
+et hermes-nabil (VPS) : bannir les tics d'écriture IA, et donner accès à Firecrawl
+(scraping/recherche web) en usage de dernier recours, pour préserver le quota gratuit
+(1000 crédits/mois, un seul compte partagé entre les 4).
+
+## Règle d'écriture naturelle
+Bloc "## ÉCRITURE — RÈGLE ABSOLUE" inséré dans les 4 SOUL.md, juste après le bloc
+"## LANGUE — RÈGLE ABSOLUE" existant. Bannit : tirets longs en cascade, formules de
+remplissage ("il est important de noter"), tricolons artificiels, hedging systématique,
+symétrie parfaite de listes, intros/conclusions génériques.
+
+Fichier de référence livré à Nabil : `HUMANISE.md` (pour diffusion à d'autres agents,
+ex. hermes-yesmine, hors infra gérée ici).
+
+Sauvegardes : `SOUL.md.bak_ecriture_20260719` sur les 4 instances.
+
+## Accès Firecrawl
+- Clé unique `FIRECRAWL_API_KEY` (un seul compte Firecrawl, quota partagé) :
+  - VPS hermes-nabil : dans `/data/.env`
+  - NAS TT/Nyora/Perso : dans `hermes-platform/.env` (racine), injectée via
+    `docker-compose.yml` (bloc `environment:` des 3 services `hermes-agent-*`)
+- Script partagé `firecrawl_scrape.py` (identique sur les 4 instances, seul le
+  chemin de dépôt change) :
+  - VPS hermes-nabil : `/data/nyora/firecrawl_scrape.py`
+  - NAS TT/Perso : `data/scripts/firecrawl_scrape.py` (dossier déjà existant)
+  - NAS Nyora : `data/scripts/firecrawl_scrape.py` (dossier créé, n'existait pas)
+  - Usage : `python3 .../firecrawl_scrape.py <url>` (scrape) ou
+    `--search "requête" [n]` (recherche)
+- Consigne SOUL.md ("## RECHERCHE WEB (Firecrawl)") : dernier recours seulement,
+  pas par réflexe, pour préserver le quota partagé entre les 4 instances.
+
+## Pièges rencontrés
+- `hermes-nyora/data/` n'avait pas de dossier `scripts/` (contrairement à TT et
+  Perso) — créé manuellement, cohérent avec la convention des deux autres.
+- `docker compose up -d <services>` interrompu par un timeout côté outil a laissé
+  hermes-agent-nyora et hermes-agent-perso en état `Created` (pas démarrés) —
+  `docker start <container>` explicite a suffi à débloquer, pas de recreate
+  nécessaire une deuxième fois.
+- `hermes-tt/data/`, `hermes-nyora/data/`, `hermes-perso/data/` sont dans le
+  `.gitignore` de `hermes-platform` (volumes runtime + secrets) — aucun commit
+  Git à faire pour les SOUL.md, seule la sauvegarde `.bak_*` fait foi. Seul
+  `docker-compose.yml` (hors `data/`) a été commité.
+- Une insertion de bloc dans le SOUL.md de hermes-nabil avait été faite sans
+  accents par accident (héritage du style non accentué du reste du fichier,
+  qui n'a jamais été ré-accentué au-delà des blocs de règles eux-mêmes) —
+  corrigé immédiatement. Le corps du SOUL.md hermes-nabil hors blocs de règles
+  reste globalement non accentué : ré-accentuation complète non faite, à
+  prévoir si ça devient gênant.
+
+## Vérification
+Testé en réel sur les 4 instances après déploiement : script exécuté avec
+`--search "test"`, résultat renvoyé correctement partout, `FIRECRAWL_API_KEY`
+confirmée présente dans l'environnement des containers NAS.