l0g.fr Risk Intelligence MCP server

l0g.fr

Journal statique (Astro 7 + Tailwind v4), édité en Markdown/MDX, versionné sur GitHub, déployé en pull-based sur un serveur Debian/Apache qui ne sert que du HTML. Infographies locales, recherche Pagefind, RSS, sitemap, aucun tracker.

Pour publier (articles, pages avec graphes, colonne de droite), voir le guide

pas à pas : docs/GUIDE-CONTENU.md.

Jouer en local

npm install
npm run dev          # http://localhost:4321

Aperçu d'un build de production (nécessaire pour tester la recherche Pagefind) :

npm run build        # astro build + indexation pagefind
npm run preview

Surfaces publiques

l0g publie aussi des surfaces lisibles par machine, utilisées par les agents IA et par les dashboards :

(signaux, sources, claims, modèles, articles et confiance).

• /agents.json : manifeste de découverte pour agents.
• /openapi.json : contrat OpenAPI 3.1 de l'API publique.
• /api/v1/risk-diff.json : diff du risque sur 1, 7 et 30 jours

l'état public du risque sans reconstruction rétroactive.

• /api/v1/black-box.json : frames point-in-time hashées pour rejouer

Radar latest.json, avec provenance, buckets et couverture lorsque disponible.

• /api/v1/risk.json : signaux de risque normalisés par instrument.
• /api/v1/debt-risk.json : snapshot canonique Dette US repris de Debt Risk

replay sans look-ahead bias.

• /api/v1/signals/history.* : historique point-in-time pour backtests et

série nommée, avec source et attribution CC BY 4.0 intégrées.

• /api/v1/signals/{slug}/chart.svg : graphique autonome 1200 × 630 d'une

code d'intégration, citations recommandées et limites de réutilisation.

• /ressources-journalistes/ et /en/press-resources/ : graphiques, exports,

recherche, documents, preuves, research packs et getriskstate, produit principal pour l’état courant, le diff, l’historique et le replay.

• /api/mcp/compact : façade MCP recommandée à six outils, avec découverte,

et usages experts autour d'Agent Surface, Risk Diff, Black Box, claims, sources, intégrité et changefeed.

• /api/mcp : surface MCP complète en lecture seule, conservée pour compatibilité

d'outils MCP complet et compact.

• /api/v1/toolset-manifest.json : versions et empreintes anti-dérive des contrats

domaine référent, plus une ventilation séparée MCP/API, previews, robots et scans ; sans identifiant persistant et avec seuil k=5.

• /api/v1/human-traffic.json : GET HTML humains agrégés par jour, page et

• /llms.txt et /llms-full.txt : cartes textuelles pour agents et RAG.

Les détails de calcul et les limites de modèle sont dans docs/MODELES-RISQUE.md et dans /methodologie/.

Outil interne de revue des claims

L'UI de revue humaine des assertions (tooling d’admin) est volontairement isolée du site public et du MCP. Elle n'est pas exposée publiquement :

• serveur local: 127.0.0.1:4317
• endpoint principal: http://127.0.0.1:4317/

Lancement :

node scripts/review-claims.mjs

Le mode commit reste strictement en terminal :

node scripts/review-claims.mjs --commit [--dry-run] [--push] --message "..."

Détails sécurité côté local :

• seul localhost est accepté,
• toutes les mutations API (/api/review, /api/remove) exigent JSON + token anti-CSRF propre à la session (x-review-token),
• validation de payload (longueurs/champs),
• anti-spam local par fenêtre de temps sur les routes de mutation,
• commit Git en mode interactif terminal uniquement avec confirmation explicite CONFIRMER.

Le MCP public et les endpoints de production ne sont pas affectés par ces options.

Dépannage rapide

En cas d’erreur dans l’UI de revue :

Shortened. The full README is on GitHub.