Pour les agents & développeurs
Laissez votre agent IA lire tout le marché des compléments
Nous scannons en continu 9 boutiques et convertissons chaque prix en prix par unité. Donnez à Claude, ChatGPT ou votre propre agent IA un accès direct, via MCP ou notre API JSON, au prix par unité le plus bas dans chaque catégorie : normalisé, actuel et prêt à citer.
Serveur MCP
Endpoint HTTP streamable, anonyme et en lecture seule. Fonctionne avec Claude (Desktop & Code), ChatGPT, Grok et tout autre client MCP. Connectez-le avec cette URL :
https://mcp.supplementscanner.chExemple de configuration pour un client MCP :
{
"mcpServers": {
"supplementscanner": {
"type": "http",
"url": "https://mcp.supplementscanner.ch"
}
}
}Grok
Dans l’app Grok : ouvrez les plugins, ajoutez un nouveau connecteur personnalisé et collez l’endpoint ci-dessus. Rien d’autre n’est nécessaire.
Grok Bot ajoute le même serveur si vous le lui demandez avec cette URL.
Via l’API xAI, ajoutez-le comme outil MCP distant :
{
"tools": [
{
"type": "mcp",
"server_url": "https://mcp.supplementscanner.ch",
"server_label": "supplementscanner"
}
]
}find_cheapestLes produits les moins chers par unité dans une catégorie.
search_productsRecherche tolérante aux fautes de frappe dans tout le catalogue.
list_categoriesToutes les catégories avec comptages en direct et prix le plus bas.
get_productDétail et historique de prix d'un produit.
API JSON
Pour les agents et frameworks qui utilisent du HTTP classique. Les mêmes données que le serveur MCP.
https://api.supplementscanner.ch/v1GET /search?q=whey&limit=10
GET /categories
GET /categories/{slug}/cheapest?limit=10
GET /products/{id}Lisible par machine : Spécification OpenAPI · llms.txt
Identifiez votre intégration
Chaque intégration doit indiquer qui l'exploite dans un en-tête de requête, sur l'API JSON comme sur le point d'accès MCP.
curl \
-H "Client-Name: Acme Labs" \
-H "Client-Domain: example.com" \
"https://api.supplementscanner.ch/v1/categories"Client-Name: obligatoire. L'entreprise, l'organisation ou la personne qui exploite l'intégration. Nommez l'exploitant, pas chacun de ses utilisateurs ; pour un projet personnel, un nom de projet ou un pseudonyme suffit.Client-Domain: recommandé. Le domaine nu du site de l'exploitant, par exemple example.com : sans https://, chemin ni port.
Conditions d'utilisation de l'API et du serveur MCP
- Envoyez Client-Name avec chaque requête, en nommant l'exploitant de façon exacte. Client-Domain est recommandé.
- Utilisez de l'ASCII simple, moins de 100 caractères par en-tête. Les deux sont déclaratifs et ne sont pas des identifiants : ils n'ouvrent aucun accès et n'augmentent pas les limites de requêtes. N'y mettez jamais de clés, de jetons, d'adresses e-mail ni d'informations sur vos utilisateurs.
- Nous pouvons ralentir ou bloquer, sans préavis, les requêtes qui n'envoient pas Client-Name, qui désignent faussement leur exploitant ou qui dépassent les limites.
- Un client qui ne permet pas d'ajouter des en-têtes, comme le connecteur d'un assistant conversationnel qu'une personne ajoute pour son propre usage, en est dispensé. Les clients MCP qui acceptent des en-têtes HTTP supplémentaires et les appels depuis un navigateur doivent les envoyer.
Bon à savoir
- Les montants sont des centimes entiers (
*_cents) plus une chaîne localisée que vous pouvez afficher littéralement, par ex. « 12.48 CHF par kg ». - Comparez les produits sur
unit_price_centspour le prix normalisé par unité. - Chaque produit contient un
buy_url: affichez-le comme lien d'achat. C'est un lien affilié, donc joignez leaffiliate_disclosurefourni. - Les deux canaux sont limités par IP ; aucune clé requise.
Vous préférez d'abord explorer ? Voir les catégories.