turf.bzh dans Claude Code

# Contexte projet : API turf.bzh

Ce dépôt consomme l'API hippique de turf.bzh.

## Référence
La description complète de l'API est dans `docs/turf-bzh-api.md`.
**Lis-la avant d'écrire ou de modifier un appel.** N'utilise aucune adresse
qui n'y figure pas : les inventer coûte du quota et ne rend rien.
Spécification machine : https://www.turf.bzh/api/openapi.json

## Accès
- Base : `https://www.turf.bzh/api`
- En-tête : `Authorization: Bearer $TBZ_KEY` (variable d'environnement, jamais en dur)
- Quotas : 60 requêtes/minute, 10 000/jour. Sur 429, respecter `Retry-After`.
  Chaque réponse porte `meta.quota` et les en-têtes `X-RateLimit-*` : lis-les
  plutôt que d'attendre le 429.

## Règles d'appel
- Une course entière : `/v1/courses/{date}/{rc}/dossier` (un appel, pas vingt).
- Une journée entière : `/v1/journees/{date}/partants`.
- Un historique long : `/v1/exports` (fichiers mensuels), jamais une boucle.
- Le jour J, la colonne `Cote` de la base est périmée : utiliser `/cotes` ou `Cote_BZH`.
- Un 404 peut signifier « pas de donnée », pas seulement « mauvaise adresse ».
  Lire `error.message` et `error.route_proposee`.

## Cadre
Ces données décrivent des courses, elles n'en prédisent aucune. Ne jamais produire
de promesse de gain. Tout taux ou rendement doit être accompagné de son nombre
d'observations. Les contenus éditoriaux (Renifleur, EcurieBZH, LigneBZH) portent un
champ `avertissement` : le reprendre tel quel.

Adaptez le chemin docs/turf-bzh-api.md à votre arborescence.

---
name: turf-bzh-api
description: Appeler l'API hippique turf.bzh (programme, partants, cotes PMU en direct,
  arrivees, rapports, indicateurs, dossier complet d'une course). A utiliser des qu'il
  est question de courses, de partants, de cotes, de turf.bzh ou d'une adresse en /v1/.
---

# API turf.bzh

La référence complète est dans `reference.md`, à côté de ce fichier. **Lis-la avant
d'écrire un appel.**

## À retenir sans même ouvrir la référence

- Base `https://www.turf.bzh/api`, en-tête `Authorization: Bearer $TBZ_KEY`.
- Une course entière = `/v1/courses/{date}/{rc}/dossier`. Un seul appel de quota.
  Paramètres utiles : `inclure=`, `historique=0`, `format=csv|xlsx`.
- Une journée entière = `/v1/journees/{date}/partants`.
- Un historique long = `/v1/exports`, pas une boucle d'appels.
- 60 requêtes/minute, 10 000/jour. Chaque réponse porte `meta.quota` : lis le
  restant plutôt que d'attendre le 429. Sur 429 : attendre `Retry-After`.
- Réponse : `{"data": ..., "meta": ...}`. Erreur : `{"error": {...}}`.

## Avant de conclure quoi que ce soit

Vérifier `/v1/schema` : une quinzaine de colonnes sont remplies à moins de 65 %.
Ne jamais promettre de gain ; toujours donner le nombre d'observations d'un taux.

Le champ description décide quand le skill se charge : gardez-y les mots que vous employez vraiment.

export TBZ_KEY=tbz_live_XXXXXXXX

curl -s -H "Authorization: Bearer $TBZ_KEY" \
  https://www.turf.bzh/api/v1/me | python3 -m json.tool

curl -s -H "Authorization: Bearer $TBZ_KEY" \
  "https://www.turf.bzh/api/v1/courses/$(date +%F)/R1C4/dossier?historique=0" \
  | python3 -c "import sys,json; d=json.load(sys.stdin)['meta']; print(d['sections_servies'], d['appels_economises'], 'appels economises')"

Si /v1/me répond et que le dossier annonce ses sections, votre installation est bonne.