Faire travailler Claude Cowork sur vos courses

Cowork ne se contente pas de repondre : il appelle l'API, ecrit des fichiers et vous les rend. Vous decrivez ce que vous voulez en francais, il produit le tableur.

Pour qui vous ne programmez pas, mais vous voulez qu'un assistant aille chercher la donnee lui-meme et vous rende un fichier exploitable.

Il vous faut une Licence API et un abonnement actif. Votre cle se genere sur api-cle.php. Ne collez jamais votre cle dans une conversation partagee ou publique : elle vaut votre acces.

Le fichier a donner a votre assistant

Un seul fichier decrit l'API en entier : les adresses, les parametres, les quotas, et surtout les pieges qui font perdre du temps. Votre assistant en a besoin, sinon il invente des adresses qui n'existent pas.

Le fichier n'est pas encore en place sur le serveur.

Pour les detenteurs de la Licence API

Et pour aller beaucoup plus loin : le pack IA

Le fichier ci-dessus apprend a votre assistant ou sont les donnees. Le pack, lui, lui apprend le metier : le vocabulaire du turf, la lecture d'une musique et d'une ferrure, les mathematiques du pari mutuel, la physionomie du Quinte+, les pieges de raisonnement, et la facon de ne jamais conclure plus que ce que les chiffres autorisent.

C'est un dossier a decompresser, pas un fichier a coller. Dix fiches de reference, seize savoir-faire, dix roles specialises, et un guide de parametrage pour que vous regliez tout vous-meme. Surtout, il fait ce que ChatBZH ne peut pas : aller lire la presse, les declarations des entraineurs et la meteo. Et quand vous demandez son avis, il le donne. Deux archives au choix, une pour Claude, une pour Codex.

Decouvrir le pack IA reserve aux comptes ayant la Licence API

Pas a pas

Donnez le fichier de reference a Cowork
Deposez turf-bzh-api.md dans la conversation. C'est ce qui evite qu'il invente des adresses : notre journal du 07/09 montre douze mille appels perdus sur deux adresses qui n'existent pas, ecrites au juge par un assistant mal renseigne.
Donnez-lui votre cle, une seule fois
Dites-lui de la garder dans une variable d'environnement et de ne jamais l'ecrire dans un fichier qu'il vous rend. Le bloc ci-dessous le dit a sa place.
Decrivez le resultat que vous voulez, pas la methode
« Je veux un fichier Excel avec les partants du jour et leur Cote BZH » suffit. Il choisira les appels.
Laissez-le verifier son travail
Demandez-lui de comparer le nombre de lignes produites au nombre_partants annonce par l'API. Une ligne manquante se voit tout de suite.
Recuperez le fichier
Cowork vous le rend directement. Il peut aussi l'ecrire dans un dossier de votre ordinateur si vous lui en avez donne l'acces.

Le message d'ouverture, a copier tel quel

Collez ceci au debut de votre conversation, apres avoir depose le fichier turf-bzh-api.md. Il pose le cadre une fois pour toutes.

Message d'ouverture Cowork

Tu vas travailler avec l'API turf.bzh. Le fichier turf-bzh-api.md que je viens de
deposer la decrit en entier : lis-le AVANT d'ecrire quoi que ce soit, et n'utilise
aucune adresse qui n'y figure pas.

Ma cle API est : tbz_live_XXXXXXXX
Mets-la dans une variable d'environnement TBZ_KEY. Ne l'ecris JAMAIS dans un fichier
que tu me rends, ni dans un message.

Regles de travail :
- 60 requetes par minute maximum. Si tu recois un 429, attends la duree Retry-After.
- Pour tout ce qui concerne UNE course, utilise /dossier : un seul appel au lieu de vingt.
- Pour une journee entiere, utilise /journees/{date}/partants, jamais une boucle par course.
- Un 404 n'est pas forcement ma faute : lis error.message, et le champ route_proposee.
- Ne me promets jamais un gain. Accompagne tout taux ou tout rendement du nombre de
  courses sur lequel il est mesure.

Commence par appeler /v1/me et /v1/statut, et dis-moi ce que tu vois.

Le dernier paragraphe sert de test : si ces deux appels passent, votre cle et la fraicheur de la base sont bonnes, et le reste suivra.

Trois demandes concretes

Une fois le cadre pose, vous parlez normalement.

Exemples de demandes

Sors-moi le dossier complet de la R1C4 d'aujourd'hui en Excel, sans l'historique
des chevaux. Ajoute une colonne : ecart en pourcentage entre la cote PMU et la Cote BZH.

---

Pour chaque course du programme d'aujourd'hui, donne-moi le nombre de partants,
la discipline, et combien de chevaux ont une Cote BZH sous 5. Un fichier CSV,
une ligne par course.

---

Prends les trente derniers jours. Pour chaque course terminee, compare le cheval
qui avait la meilleure Note IA a l'arrivee reelle. Combien de fois dans les trois
premiers ? Sur combien de courses ? Utilise les exports mensuels, pas des appels
course par course.

La derniere precision compte : sans elle, un assistant boucle sur des milliers d'appels et epuise votre quota du jour en une heure.

Deux consignes a donner a votre assistant, et qu'il oubliera sinon

Qu'il accompagne toujours un taux ou un rendement de son nombre d'observations, et qu'il reprenne les champs avertissement que l'API renvoie avec les contenus editoriaux. Le fichier turf-bzh-api.md le dit deja dans sa derniere section : c'est voulu, pour que l'assistant le lise. Le reste, vous le savez : le prelevement PMU s'applique a chaque mise, et un avantage mesure sur le passe n'est pas une garantie sur l'avenir.

Questions frequentes

Est-ce que Cowork va gaspiller mon quota ?

Pas si vous lui donnez les trois regles du message d'ouverture. Le vrai piege est la boucle course par course : le fichier de reference explique quelles adresses la remplacent, et le message d'ouverture le lui rappelle.

Ma cle est-elle en danger ?

Elle circule dans votre conversation. Ne la partagez pas, et si vous avez un doute, revoquez-la et regenerez-en une sur api-cle.php : la licence, elle, reste acquise.

Cowork peut-il ecrire dans mes dossiers ?

Oui, si vous lui donnez acces a un dossier de votre ordinateur. C'est pratique pour qu'il depose ses fichiers la ou vous travaillez deja.

Et si je veux automatiser tous les matins ?

C'est le moment de passer a Claude Code ou a un simple script : une tache repetee tous les jours gagne a etre du code stable plutot qu'une conversation.

Documentation complete pour les humains : api-docs.php · Specification machine : openapi.json · Votre cle : api-cle.php