Judilibre — jurisprudence judiciaire
Ce skill interroge l'API Judilibre (Cour de cassation) pour rechercher et lire
des décisions de justice de l'ordre judiciaire. Le travail se fait via le script
scripts/judilibre_client.py, qui gère l'authentification et renvoie du JSON.
Périmètre — à dire à l'utilisateur si besoin
- ✅ Couvre : Cour de cassation (toutes chambres), et de plus en plus les cours
d'appel et juridictions du premier degré (montée en charge progressive).
- ❌ Ne couvre PAS : les textes (codes, lois, décrets) ni la jurisprudence
administrative (Conseil d'État, CAA, TA). Pour cela, renvoyer vers OpenLegi /
Légifrance ou une autre source.
Configuration (une seule fois)
Le script a besoin d'une clé PISTE et d'un accès réseau autorisé.
-
Clé d'API (mode KeyId — recommandé). Une simple clé d'API suffit : c'est
le mode KeyId, où la clé est envoyée dans l'en-tête HTTP. Le script lit la clé
dans cet ordre : argument --key, variable d'environnement
JUDILIBRE_KEY_ID, puis scripts/config.json. Si aucune clé n'est trouvée,
le script renvoie une erreur explicite. Dans ce cas, demander sa clé à
l'utilisateur, puis créer scripts/config.json à partir de
scripts/config.example.json en collant la clé dans le champ key_id et en
réglant env sur prod (ou sandbox). Le client OAuth (client_id /
client_secret) n'est PAS nécessaire en mode KeyId : laisser ces champs vides.
Mode OAuth2 (avancé, repli). Si l'utilisateur n'a pas de KeyId mais un couple
client_id / client_secret, renseigner ces deux champs et laisser key_id
vide ; le script obtiendra et mettra en cache un jeton Bearer automatiquement.
⚠️ scripts/config.json contient la clé en clair : ne jamais l'afficher ni le
partager.
-
Réseau. L'appel sort vers *.piste.gouv.fr. Si le script renvoie une
erreur « Connexion impossible à piste.gouv.fr » ou « Domaine réseau non
autorisé », prévenir l'utilisateur qu'il doit autoriser le domaine dans les
réglages réseau de l'exécution de code de Claude :
api.piste.gouv.fr — indispensable (production, mode KeyId) ;sandbox-api.piste.gouv.fr — seulement pour le bac à sable ;oauth.piste.gouv.fr et sandbox-oauth.piste.gouv.fr — seulement pour le
mode OAuth2.
Vérifier que tout fonctionne : python3 scripts/judilibre_client.py test.
Cette commande effectue une vraie recherche authentifiée (et non un simple
healthcheck), donc un succès confirme bien que la clé est acceptée.
Utilisation
Installer la dépendance si nécessaire : pip install requests (silencieux si
déjà présent).
Rechercher
python3 scripts/judilibre_client.py search "période d'essai rupture abusive" \
--chamber soc --page-size 10
Filtres disponibles (tous facultatifs). Plusieurs valeurs sont acceptées pour
les filtres de catégorie (les séparer par un espace) :
--chamber (soc, civ1, civ2, civ3, comm, crim…), --jurisdiction (cc, ca, tj),
--type, --theme, --publication, --solution, --field,
--operator (and|or|exact), --date-start AAAA-MM-JJ, --date-end AAAA-MM-JJ,
--page, --page-size (max 50), --sort (score|date), --order (asc|desc).
Exemple multi-valeurs : --chamber soc comm cherche dans les deux chambres.
La sortie est du JSON. Champs utiles par résultat : id, number/numbers,
jurisdiction, chamber, formation, decision_date, solution, ecli,
publication, summary, themes, score, et url (lien public direct vers
la décision sur courdecassation.fr, ajouté par le script).
Lire une décision complète
Reprendre l'id d'un résultat de recherche :
python3 scripts/judilibre_client.py decision <id>
Renvoie le texte intégral (text), un lien public (url) et le zonage
(zones : introduction, exposé, moyens, motivations, dispositif, annexes).
Connaître les valeurs d'un filtre
python3 scripts/judilibre_client.py taxonomy chamber
Présentation des résultats à l'utilisateur — TOUJOURS
Après une recherche, ne pas recracher le JSON brut. Présenter une liste claire,
classée par pertinence, où chaque décision indique : juridiction et chambre,
numéro de pourvoi, date, solution (cassation, rejet…), niveau de publication
(P, B…), un résumé court si disponible, et le lien public (url) vers le
texte. Conserver l'id pour pouvoir ouvrir le texte intégral à la demande.
Proposer d'afficher l'arrêt complet ou d'affiner la recherche (chambre, période).
Toujours rappeler que ce sont des décisions de l'ordre judiciaire uniquement.
En cas d'erreur
Le script renvoie des messages JSON explicites (error + fix). Les relayer
simplement à l'utilisateur :
- clé manquante → demander la clé et l'enregistrer dans
scripts/config.json ;
- 401 → mauvaise clé ou mauvais environnement (sandbox vs prod) ;
- 403 → CGU Judilibre non validées ou API non rattachée à l'application PISTE ;
- 429 / 5xx → quota atteint ou API indisponible ; le script réessaie
automatiquement, sinon attendre un peu et relancer ;
- connexion impossible / domaine non autorisé → autoriser
api.piste.gouv.fr
dans les réglages réseau.