API FFE Échecs — Données joueurs officielles, stables et faciles à intégrer
Accédez aux données des joueurs licenciés FFE via une API REST simple et fiable. Recherchez par nom, licence ou club. Obtenez les classements Elo, catégories, et informations officielles — sans scraping.
Accéder aux données joueurs FFE ne devrait pas être un casse-tête
Aujourd'hui, récupérer les informations des joueurs d'échecs français demande du bricolage et beaucoup de patience.
Pas d'API publique officielle
La FFE ne propose aucune interface programmatique pour accéder aux données joueurs.
Scraping fragile et instable
Le site officiel peut changer à tout moment, cassant vos scripts sans préavis.
Parsing HTML complexe
Extraire des données structurées depuis du HTML mal formaté est une source de bugs.
Maintenance permanente
Chaque modification du site FFE nécessite de réécrire votre code d'extraction.
Perte de temps, bugs et maintenance permanente
Une vraie API pour les données échecs françaises
Notre API REST vous donne accès aux données officielles des joueurs FFE de manière simple, stable et fiable. Concentrez-vous sur votre application, pas sur le scraping.
- Plus de scraping ni de parsing HTML
- Données structurées en JSON propre
- Endpoints REST simples et documentés
- Authentification par clé API sécurisée (X-API-Key)
- Synchronisation régulière avec la FFE
- Inclusion FIDE optionnelle (?include=fide,fide_ratings)
curl -fsS \
-H "X-API-Key: YOUR_API_KEY" \
https://ffe.chessxp.com/api/player/W53002
// Réponse JSON (extrait)
{
"ffe_licence_number": "W53002",
"last_name": "…",
"first_name": "…",
"club": "…",
"league": "…",
"federation": "FRA",
"category": "SenM",
"standard_rating": 1800,
"rapid_rating": 1750,
"blitz_rating": 1700,
"fide_id": 123456,
"is_active_this_season": true
}Tout ce qu'il vous faut pour intégrer les données FFE
Une API complète et alignée sur le service en production (ffe.chessxp.com).
Base joueurs FFE officielle
Base SQLite synchronisée automatiquement chaque lundi à 03:00 UTC (Cloud Scheduler) depuis les données officielles FFE.
8 endpoints REST
Lookup par licence, id interne ou FIDE ; batch jusqu'à 50 licences ; recherche par nom ou club ; annuaire des clubs.
Filtres avancés
Paramètres league, federation, min_rating, max_rating, category (pPo, Po, Pu, Ben, Min, Cad, Jun, Sen, Sen+, Vet ± M/F).
Inclusion FIDE
?include=fide,fide_ratings : liste officielle mensuelle en cache ; en cas d'absence, complément via Lichess (timeouts documentés).
Serveur MCP intégré
Point d'entrée /mcp (HTTP streamable), même en-tête X-API-Key que /api/* — idéal pour Cursor, Claude Desktop, etc.
Authentification simple
Header X-API-Key, allowlist par projet, rate-limit configurable ; clés internes ChessXP sans quota.
Confidentialité par défaut
Date de naissance et ville omises par défaut ; opt-out joueur (RGPD) via blocklist — voir PRIVACY.md du service.
Health & fraîcheur
GET /health expose row_count, last_refresh_utc, stale_days_since_refresh pour surveiller la fraîcheur des données.
Pour qui ?
Que vous soyez développeur indépendant, club d'échecs ou plateforme établie, notre API s'adapte à vos besoins.
Applications web et mobile
Intégrez les données joueurs dans vos apps chess pour afficher profils et classements.
Outils de gestion de club
Gérez vos adhérents avec des données à jour : licences, Elo, catégories.
Plateformes de tournois
Pré-remplissez les inscriptions et vérifiez les classements automatiquement.
Tableaux de bord ligues
Créez des dashboards pour comités et ligues avec statistiques régionales.
Data science & statistiques
Analysez l'évolution du chess français, tendances Elo, démographie.
Bots Discord & SaaS
Alimentez vos bots et services en données joueurs en temps réel.
Pourquoi ne pas scraper ?
Le scraping peut sembler une solution rapide, mais c'est une dette technique qui vous coûtera cher.
Scraping du site FFE
- Instable — casse à chaque changement du site
- Lent — parsing HTML coûteux en ressources
- Risque légal — scraping parfois interdit
- Non structuré — données brutes à transformer
- Maintenance lourde — code à réécrire souvent
API FFE ChessXP
- Stable — endpoints versionnés et maintenus
- Rapide — réponses JSON optimisées
- Légal — accès autorisé avec clé API
- Structuré — schéma de données clair
- Durable — évolutions documentées
Construisez sur des bases solides, pas sur du bricolage
Comment ça marche ?
De la demande d'accès à votre première requête en 4 étapes simples.
Remplissez le formulaire
Décrivez votre projet et vos besoins en quelques lignes.
Recevez votre clé API
Nous validons votre demande et vous envoyons votre clé par email.
Consultez la documentation
Explorez les endpoints, paramètres et exemples disponibles.
Faites votre première requête
Intégrez l'API dans votre application en quelques minutes.
curl -fsS \
-H "X-API-Key: YOUR_API_KEY" \
https://ffe.chessxp.com/api/player/W53002Variante FIDE (liste officielle + ratings) : ajoutez ?include=fide,fide_ratings à la même URL.
Point d'entrée /mcp, /docs-mcp, llms.txt et schéma OpenAPI en Markdown : voir la section Intégrer avec une IA.
Intégrer avec une IA (Cursor, Claude, Codex…)
Même approche « développeur d'abord » : pointez votre agent vers llms.txt, branchez le MCP produit ou le MCP docs, téléchargez le schéma OpenAPI en Markdown.
MCP produit (données joueurs)
Même X-API-Key que l’API REST — endpoint /mcp
{
"mcpServers": {
"ffe-chessxp": {
"url": "https://ffe.chessxp.com/mcp",
"headers": { "X-API-Key": "${FFE_API_KEY}" }
}
}
}Catalogue JSON des outils : ffe.chessxp.com/mcp/catalog.json
MCP docs (sans clé)
Recherche et lecture des fichiers markdown publics (README, MODULES, runbook…)
{
"mcpServers": {
"ffe-docs": {
"url": "https://ffe.chessxp.com/docs-mcp"
}
}
}llms.txt
Fichier index pour agents : cartographie des URL (REST, OpenAPI, MCP). Côté API : ffe.chessxp.com/llms.txt — sur ce site marketing : /llms.txt.
OpenAPI en Markdown
Endpoints REST & outils MCP
Aperçu du périmètre public documenté sur ffe.chessxp.com/docs. Les routes opérateur (refresh, opt-out) sont hors schéma OpenAPI.
REST (8 routes)
| Méth. | Chemin | Rôle |
|---|---|---|
| GET | /api/player/{licence} | Joueur par numéro de licence (?include=fide,…) |
| GET | /api/player/id/{id} | Joueur par identifiant interne SQLite |
| GET | /api/player/fide/{fide_id} | Joueur par identifiant FIDE |
| GET | /api/player/batch?licences=… | Jusqu'à 50 licences (liste séparée par virgules) |
| GET | /api/player/search-by-name?last_name=… | Recherche par nom (+ filtres optionnels) |
| GET | /api/player/search-by-club?club=… | Recherche par club (+ filtres optionnels) |
| GET | /api/club/list | Annuaire des clubs (slug, effectifs) |
| GET | /api/club/{slug}/players | Joueurs rattachés à un club |
MCP (5 outils)
Même X-API-Key — endpoint /mcp
| Outil | Rôle |
|---|---|
| lookup_player | Licence FFE, id interne ou fide_id ; include fide / fide_ratings |
| batch_lookup_players | 1 à 50 licences en un appel |
| search_players_by_name | Nom de famille (+ prénom) et filtres optionnels |
| search_players_by_club | Recherche club + filtres optionnels |
| list_clubs | Annuaire paginé (clubs + total) |
Schéma complet : Swagger /docs · openapi.json
Demander un accès API
Décrivez votre projet en quelques lignes. Nous validons et vous envoyons votre clé sous 1 à 2 jours ouvrés.
Questions fréquentes
Tout ce que vous devez savoir sur l'API FFE ChessXP.