Nouveau · compris dans la Licence API

Votre assistant IA, formé au turf

Claude et Codex savent écrire, calculer et chercher. Ils ne savent rien des courses. Le pack IA leur apprend le métier : les 36 adresses réelles de l'API turf.bzh et leurs pièges, le sens exact de chaque champ, la grammaire du turf, les mathématiques du pari mutuel, la physionomie du Quinté+ mesurée sur plus de 5 000 courses. Puis il leur fait faire ce que ChatBZH ne peut pas : aller lire la presse, les déclarations des entraîneurs et la météo. Et quand vous demandez leur avis, ils le donnent. Vous décidez.

Il ne promet aucun gain : le prélèvement PMU s'applique à chaque mise, et vous le savez déjà. Ce qu'il change, c'est la qualité de ce que votre assistant vous dit.

Ce qu'il y a dedans

11 fiches de référence forment sa mémoire longue : l'API et le dictionnaire de données champ par champ, la grammaire du turf (musique, ferrure, corde, engagement, les 11 paris), les mathématiques du pari (probabilité implicite, Kelly, Harville, Borda, Dutching, réducteurs), le Quinté+ avec la table des rangs de cote sur 3 479 courses et douze formes de ticket mesurées sur 3 706 courses, et seize pièges de raisonnement avec le test qui les détecte.

Et surtout, ce que l'API permet vraiment. Une fiche entière recense les compositions : le dossier d'une course qui rend aussi l'historique de chaque partant en un seul appel là où il en faudrait 21, les 34 indicateurs de classement avec leur sens de tri, et les endroits où la documentation officielle sur-promet. Un assistant qui connaît les 36 adresses ne sait pas encore ce qui est possible ; celui-ci, si.

Chaque chiffre porte son nombre d'observations. Un assistant équipé qui vous annonce « 26 % » vous dira « 26 % sur 3 479 Quintés+ ». Si l'échantillon manque, c'est qu'il a inventé, et vous le saurez.

Ce que le pack ajoute : le web

ChatBZH, sur le site, connaît la base par cœur et répond sans que vous ayez rien à installer : pour une question ponctuelle sur une course, un cheval ou un rapport, c'est le chemin le plus court. Le pack joue sur un autre terrain. Claude et Codex disposent de la recherche web, et le pack leur apprend où aller, quoi chercher, et à rendre chaque information avec sa source et sa date. Les deux se complètent, et beaucoup de turfistes utilisent les deux dans la même journée.

Ce que cela change, concrètement

Sans le pack	Avec le pack
L'assistant invente une adresse d'API et vous rend une erreur 404.	Il connaît les 36 adresses réelles, leurs paramètres, et sait qu'un dossier de course remplace 21 appels.
« Ce cheval gagne 34 % du temps. »	Le taux avec son nombre de courses, et combien de paris il faudrait pour que l'avantage soit prouvé.
Il lit 1p après 0a 0a 0a comme un cheval en progrès.	Il sépare les disciplines, décode chaque symbole, et signale l'artefact.
Il analyse le peloton de la veille.	Il a lu les non-partants, les déclarations et la météo du matin.
« Je ne peux pas vous donner de pronostic. »	Une sélection classée, base, associés, outsiders, un niveau de confiance par cheval, et ce qui la ferait changer.
Une mise au hasard, ou pas de mise du tout.	Kelly fractionné sur votre bankroll, le calcul, et ce qu'il suppose.

Deux archives, une par outil

Le même savoir, mis en forme pour l'outil que vous utilisez. Prenez celle qui correspond. Vous l'avez déjà ? La date sous chaque bouton dit de quand elle date : si elle est plus récente que la vôtre, mettez votre dossier à jour, il n'y a rien à réinstaller.

L'installer : trois gestes, et une phrase à coller

Le pack ne s'installe pas, il se pose. Rien à compiler, rien à ajouter sur votre machine : ni Python, ni bash, ni WSL. Votre assistant fait le reste lui-même.

1. Décompressez l'archive
   Vous obtenez un dossier, turf-bzh-claude ou turf-bzh-codex. Posez-le où vous voulez.
2. Ouvrez votre assistant dans ce dossier
   Claude Code ou Codex, lancé depuis ce dossier : c'est ce qui lui fait trouver ses instructions. Sans terminal, Claude sur claude.ai lit les mêmes fichiers déposés dans une conversation.
3. Collez cette phrase
   Il lit le pack, mesure ce qui manque, écrit votre clé et votre profil avec vous, et finit par la liste des questions que vous pouvez lui poser.

Sous Codex, remplacez CLAUDE.md par AGENTS.md. Et si vous n'avez pas encore de clé API, collez quand même : l'assistant vous dira exactement quoi faire, et le pack fonctionne déjà sans elle sur vos exports XLSX.

Le mettre à jour : une archive, une phrase

Le pack évolue quand l'API évolue. Quand la date affichée plus haut est plus récente que la vôtre, vous n'avez rien à réinstaller : téléchargez la nouvelle archive, glissez-la dans votre assistant, et demandez-lui de mettre le dossier à jour. Il s'en charge, fichier par fichier.

1. Téléchargez la nouvelle archive
   Le bouton de votre outil, plus haut sur cette page. Inutile de la décompresser.
2. Glissez le zip dans la conversation
   Dans Claude Code ou Codex ouvert sur votre dossier, ou dans une conversation sur claude.ai. Le fichier suffit, tel quel.
3. Collez cette phrase
   Votre assistant remplace ce qui a changé, laisse vos fichiers tranquilles, et vous dit ce qui est nouveau.

Vos trois fichiers ne bougent pas. .env porte votre clé, profil.md votre façon de jouer, CONTEXTE/09-mes-regles.md vos règles à vous. La phrase ci-dessus les nomme pour que votre assistant les laisse en place ; sous Codex, ajoutez config.toml à la liste. Si vous préférez la prudence, copiez votre dossier ailleurs avant : tout est en texte, rien n'est compilé.

Le README du pack porte un journal des versions daté : c'est là que vous lisez ce qui a changé, et pourquoi. Votre assistant peut vous le résumer.

Vérifier que tout est branché

Une phrase, à tout moment : « Vérifie que tout est bien branché. » Votre assistant contrôle les quatre connexions et vous rend un tableau. Il fait ce contrôle avec ses propres outils, sans rien installer.

Connexion	Ce que vous devez lire	Sinon
Clé API	valide, HTTP 200	401 : clé absente ou mal recopiée dans .env. 403 : abonnement turf.bzh expiré, la licence reste acquise. 429 : quota atteint, ce n'est pas un défaut d'installation
Base de données	fraîche, avec la date de la dernière journée	stale veut dire qu'il n'y a que la veille, empty qu'il faut attendre le rafraîchissement du matin
Recherche web	active	indisponible dans certains environnements fermés. L'API et les fiches suffisent, c'est la presse et la météo qui manqueront
Fiches et savoir-faire	11 fiches, 17 savoir-faire	un compte inférieur veut dire que l'assistant n'a pas été lancé dans le dossier du pack

Si rien ne sort du tout vers l'API, faites-lui appeler un site quelconque : s'il échoue aussi, c'est l'environnement qui n'a pas de sortie réseau (le cas des bacs à sable) ; s'il répond et que seul turf.bzh échoue, c'est un pare-feu ou un proxy qui filtre le domaine. Le pack sait faire cette distinction tout seul, et vous le dit.

Quoi lui demander

Il n'y a pas de commande à retenir : vous écrivez en français. Voici de quoi commencer, de la question la plus simple à la plus engageante. Copiez-les telles quelles, elles fonctionnent.

Pour...	Dites-lui
voir le programme	Le programme du jour, en trot attelé, avec les heures de départ.
comprendre une ligne	Explique-moi la musique du 7, symbole par symbole.
analyser une course	Analyse le Quinté+ d'aujourd'hui et donne-moi ta sélection, avec ton niveau de confiance.
savoir ce qui se dit	Qu'est-ce qu'on dit du 3 ? Déclarations, non-partants, état du terrain.
lire la presse d'un coup	Fais-moi la synthèse des pronostics publiés sur le Quinté+ de demain, et leur dispersion.
chiffrer un ticket	2 bases et 6 associés au Quinté+, ça coûte combien ? Détaille le calcul.
dimensionner une mise	Combien je mise là-dessus, avec ma bankroll ? Montre-moi le calcul de Kelly et ce qu'il suppose.
chercher un écart	Quels chevaux ont une Cote BZH nettement plus basse que leur cote PMU, et qu'est-ce que cet écart signifie exactement ?
lire un mouvement de cote	La cote du 7 est passée de 12 à 6 depuis ce matin. Montre-moi la série des relevés et sur quelle durée elle a bougé.
préparer une journée	Prépare ma journée de samedi : garde au plus quatre courses, et dis-moi surtout pourquoi tu écartes les autres.
jauger un entraîneur	Cet entraîneur est-il bon ? Sur combien d'engagements, et que reste-t-il de l'écart une fois rétréci ?
vous faire contredire	Démolis ta propre analyse. Qu'est-ce qui ne tient pas ?
comprendre une perte	Voici mon journal de la semaine. Pourquoi j'ai perdu ? Sépare ce que le prélèvement retire à tous les coups de ce qui vient de mes choix.
tester une méthode	Voici ma méthode, en une phrase. Backteste-la sur six mois et dis-moi honnêtement si elle tient.

Sonnet, Opus ou Fable ?

Claude Code laisse changer de modèle en cours de session avec /model, suivi d'un nom. Les quatre lisent le pack de la même façon : ce sont des fichiers texte, ils ne dépendent d'aucun modèle. Ce qui change, c'est la profondeur du raisonnement quand la question est ouverte, et la vitesse quand elle ne l'est pas.

Modèle	Vitesse	Quand le prendre
haiku	la plus rapide	vous savez déjà ce que vous voulez : lire une musique, chiffrer un ticket, convertir une cote
sonnet	rapide	le choix par défaut. Le programme, l'analyse d'une course, la recherche presse : l'usage quotidien
opus	modérée	les longues chaînes sans perdre le fil : une journée entière à préparer, un backtest, une analyse qui enchaîne dix appels
fable	la plus lente	rare, et pour les questions vraiment ouvertes : « démolis mon analyse », « est-ce que ma méthode tient vraiment ? »

Ce que ça consomme. Sur les forfaits Claude, vous ne payez pas au message : vous consommez une limite d'usage, et un modèle plus lourd la consomme plus vite. Au 08/09/2026, d'après la documentation Anthropic : Opus est le modèle par défaut des forfaits Max, Team Premium et Enterprise, Sonnet celui des forfaits Pro et Team Standard. Fable n'est le défaut nulle part : sur Max et les sièges premium, vous pouvez y consacrer jusqu'à la moitié de votre limite hebdomadaire sans supplément, puis il passe sur des crédits payants ; sur Pro, il consomme des crédits dès le premier message, et Claude Code vous demande votre accord avant de facturer.

Si vous ne voulez pas y penser : sonnet pour la journée courante, opus quand vous préparez un gros samedi ou demandez un backtest. /model opusplan est un bon compromis, il raisonne en Opus puis exécute en Sonnet. Changer de modèle ne recharge pas la conversation : après un changement, demandez-lui de relire vos règles avant de conclure.

Tirer le meilleur du pack

Six habitudes, dans l'ordre où elles paient.

1. Remplissez le profil, vraiment. C'est le réglage le plus rentable. Sans bankroll, il calcule sur une hypothèse ; avec, il calcule sur la vôtre. Sans vos disciplines, il vous cite des taux toutes disciplines confondues, qui ne vous concernent pas. Trois champs suffisent, deux minutes.
2. Demandez le dossier, pas les morceaux. « Analyse la R1C4 » déclenche un seul appel qui rapporte tout : partants, indicateurs, cotes, historique, lectures. Demander cheval par cheval coûte vingt fois plus d'appels et donne une réponse moins cohérente.
3. Faites-le sortir sur le web. Les déclarations, les non-partants, le terrain, les pronostics de la presse : rien de tout cela n'est dans la base. C'est la couche que les chiffres seuls ne donnent pas.
4. Réclamez l'échantillon, et ce qui ferait changer d'avis. Un taux sans son nombre de courses ne vaut rien, et le pack impose de le donner. La ligne « ce qui me ferait changer d'avis » est celle qui vous dit quoi surveiller d'ici le départ.
5. Faites-vous contredire. « Démolis ta propre analyse » est le moyen le plus simple de voir si un raisonnement tient. Une analyse qui survit à sa relecture vaut mieux qu'une analyse jamais relue.
6. Écrivez vos règles une fois pour toutes. Chaque règle posée dans votre fichier de règles s'applique à toutes les sessions suivantes. « Je ne joue jamais un cheval qui n'a pas couru depuis plus de 90 jours », écrit une fois, vous évite de le redire cent fois.

Et une chose à ne pas faire : ne lui demandez pas de tout charger d'un coup. Les 11 fiches font 200 à 600 lignes chacune, et sont écrites pour être lues une par une, au moment où elles servent.

Vous êtes l'architecte

Tout est en texte, rien n'est compilé. Deux fichiers vous appartiennent : profil.md, qui dit qui vous êtes (disciplines, hippodromes, bankroll, façon de jouer, sources de presse que vous lisez), et 09-mes-regles.md, vos règles à vous, en français. L'assistant les applique même quand elles contredisent ses statistiques, et vous le signale une fois, avec le chiffre et son échantillon. Les rôles se retirent d'un déplacement de fichier, les savoir-faire se modifient au bloc-notes, et un guide de paramétrage écrit pour quelqu'un qui n'a jamais ouvert un terminal explique chaque réglage et son effet.

Quand vous demandez sa sélection, il la donne, avec sa confiance et ses raisons. Si vous voulez la faire démolir, un rôle sceptique est là pour cela. Il ne s'impose jamais : c'est vous qui l'appelez.

Questions fréquentes

Compris dans la même licence

La Licence : api-licence.php · Votre clé : api-cle.php · Documentation de l'API : api-docs.php · Choisir son assistant : Claude, Cowork, Claude Code, Codex