Réutiliser les données

L'API REST

Toutes les données du site sont disponibles en JSON, en lecture seule, à l'adresse https://equisearch.fr/api/v1. La documentation décrit chaque point d'accès et permet de l'essayer.

Documentation de l'API

Le serveur MCP

Le protocole MCP (Model Context Protocol) permet à un assistant d'IA de consulter Equisearch pendant une conversation : il cherche un équidé, lit sa fiche, son pedigree, sa famille ou sa consanguinité, simule un accouplement ou compare une annonce au registre. Le serveur est en lecture seule et sans authentification ; il utilise le transport HTTP « streamable ».

Les outils proposés à l'assistant

• search : chercher un équidé par son nom (format attendu par ChatGPT)
• fetch : lire la fiche complète d'un équidé (format attendu par ChatGPT)
• search_horses : chercher par nom, race, sexe, robe ou années de naissance
• get_horse : la fiche d'un équidé, avec ses parents, ses performances et sa place dans le registre
• get_pedigree : le pedigree sur 3 à 6 générations et les ancêtres répétés
• get_family : les frères et sœurs (propres, utérins, de même père) et le résumé des produits
• get_inbreeding : le coefficient de consanguinité et les ancêtres communs (notation 3×4)
• virtual_mating : l'accouplement virtuel, avec la consanguinité et la robe probable du poulain ou de la pouliche
• relationship : le lien de parenté entre deux équidés et le chemin vers leurs ancêtres communs
• list_breeds : les races, de la plus nombreuse à la moins nombreuse
• get_breed : une race, avec ses effectifs, ses naissances par an, ses robes et le résumé de Wikipédia
• foal_name : la lettre de l'année, les homonymes d'un nom et des idées de noms
• compare_ad : les écarts entre une annonce de vente et le registre

Ajouter le serveur à votre assistant

Procédures vérifiées le 23 octobre 2026 dans la documentation de chaque éditeur, dont les menus sont cités comme elle les nomme (en anglais quand elle n'existe qu'en anglais). Elles peuvent avoir changé depuis.

{
  "mcpServers": {
    "equisearch": {
      "url": "https://equisearch.fr/api/mcp"
    }
  }
}

{
  "servers": {
    "equisearch": {
      "type": "http",
      "url": "https://equisearch.fr/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "equisearch": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://equisearch.fr/api/mcp"
      ]
    }
  }
}

npx mcp-remote https://equisearch.fr/api/mcp

Limites

• Chaque adresse IP dispose de 300 requêtes par minute, partagées entre l'API et le serveur MCP.
• Les opérations coûteuses comptent pour 5 : accouplement virtuel, parenté, étalons comparés à une jument et pedigree de plus de 5 générations.
• Au-delà, l'API répond 429 avec l'en-tête Retry-After (délai en secondes) ; par MCP, l'outil renvoie une erreur avec le même message.

Les réponses de l'API indiquent combien de temps les garder (Cache-Control, max-age) : les réutiliser pendant ce délai épargne le quota. Une revalidation (If-None-Match, réponse 304) compte quand même comme une requête.

Citer la source

Reproduisez cette mention avec les données, où que vous les publiiez :

Source : IFCE, fiches publiques d'infochevaux.ifce.fr, extraction du 16/08/2026, via API Équidés (Collectif Pixel). Site non affilié à l'IFCE ; les fiches officielles font seules autorité. Licence Ouverte / réutilisation d'informations publiques (CRPA, art. L321-1).

Les valeurs calculées par Equisearch (consanguinité, accouplement virtuel, parenté, prévision de robe, lettre de l'année…) ne sont pas des données officielles de l'IFCE. Chaque résultat du serveur MCP les nomme dans son champ notice, avec cette mention.

Les résumés Wikipédia des races sont sous licence CC BY-SA 4.0 ; leur source accompagne chaque résumé.

Les fiches publiques de l'IFCE sont des informations publiques réutilisables (CRPA, art. L321-1).

Lire la Licence Ouverte 2.0