Donnez à vos assistants IA la connaissance du basket français.
Résultats, calendriers de toutes les divisions, classements de poules, fiches de clubs et scores en direct : interrogez la FFBB en langage naturel (Cursor, Claude, Copilot) ou intégrez l'API en Python avec ffbb-data-client.
« Quel est le bilan et le prochain match de l'équipe 1 de Pau ? »
ffbb_team_summary :• Équipe : Élan Béarnais Pau-Lacq-Orthez (NM1)
• Bilan actuel : 3e de la poule B (14 Victoires - 4 Défaites)
• Dernier résultat : Victoire 82 - 76 vs Dax Gamarde
• Prochain match : Samedi 20h00 à domicile vs Tours
12 Outils pour explorer tout le basket français
Votre assistant IA sélectionne automatiquement le meilleur outil pour vous répondre avec une précision totale.
ffbb_team_summary
Le résumé ultime en un seul appel : bilan de la saison, position au classement, dernier résultat et prochain match à jouer.
ffbb_lives
Scores en temps réel, quarts-temps et statut des matchs en cours sur l'ensemble des championnats français.
ffbb_bilan
Bilan exhaustif d'une équipe toutes phases confondues : victoires, défaites, points marqués/encaissés et goal-average.
ffbb_club
Fiche complète d'un club : calendrier des matchs du week-end, liste des équipes engagées et classements officiels.
ffbb_search
Recherche universelle et rapide : clubs, compétitions, tournois, gymnases, arbitres et terrains de basket 3x3.
ffbb_next_match / last_result
Détails précis de la prochaine rencontre programmée ou de la dernière feuille de match jouée.
Connectez votre client IA préféré
Ajoutez l'URL Streamable HTTP officielle dans votre configuration et commencez immédiatement à poser vos questions.
// Dans .cursor/mcp.json ou Paramètres > Features > MCP
{
"mcpServers": {
"ffbb": {
"url": "https://ffbb.desimone.fr/mcp"
}
}
}Le Moteur : SDK ffbb-data-client
Le serveur MCP repose sur le package officiel Python disponible sur PyPI. Développez vos propres applications, sites de clubs ou scripts d'analyse.
# Installation via pip
pip install ffbb-data-client
# Utilisation rapide en Python (async ou synchrone)
from ffbb_data_client import FFBBDataClient
# Résolution automatique des accès et initialisation du client
client = FFBBDataClient.create()
# Recherche globale multi-index (clubs, compétitions, gymnases)
results = client.multi_search("Stade Clermontois")
# Récupération des scores live en direct le week-end
lives = client.get_lives()
for match in lives or []:
print(f"{match.equipe_domicile} vs {match.equipe_exterieur} : {match.score_domicile}-{match.score_exterieur}")Transparence & État du Service
Suivez les métriques de trafic, l'efficacité du cache et l'état des connexions en temps réel.
📊 Dashboard Visuel
Visualisez les requêtes par seconde, le hit ratio du cache et les outils les plus appelés.
📈 Métriques JSON
Endpoint automatisé au format JSON pour Prometheus, Grafana ou supervision externe.
❤️ État de Santé
Health check en direct validant la connectivité Directus et Meilisearch.
Questions fréquentes
Tout ce que vous devez savoir pour démarrer et utiliser le serveur MCP et le SDK Python.
Il suffit d'ajouter l'URL https://ffbb.desimone.fr/mcp dans votre client MCP (Cursor, Claude Desktop, Copilot). Votre IA saura automatiquement utiliser les 12 outils spécialisés pour vous répondre.
Le serveur MCP est une interface conçue spécifiquement pour les LLMs (Claude, Cursor, Copilot) avec des outils d'agrégation "one-shot" pour réduire les tokens consommés. Il est propulsé par ffbb-data-client, le SDK Python complet disponible sur PyPI (pip install ffbb-data-client) pour les développeurs d'applications.
Vous pouvez demander le classement d'une poule, le prochain match d'une équipe, le résumé complet de saison d'un club, les gymnases à proximité ou les scores des matchs en direct le week-end sur toutes les divisions (Départemental, Régional, National, Élite).
Non ! Pour utiliser le serveur MCP dans votre IA, l'instance publique https://ffbb.desimone.fr/mcp est hébergée et prête à l'emploi. L'installation Python n'est requise que si vous souhaitez développer votre propre code avec la bibliothèque ffbb-data-client.
Oui, toutes les données proviennent directement des flux officiels de la Fédération Française de BasketBall via le SDK ffbb-data-client avec une actualisation en direct pour les scores du week-end.