Pour les agents

API pour les agents

Banklabs expose une petite surface d'API et conventions pensées pour les agents IA.

Markdown des pages

Toute page publique peut être obtenue en Markdown via la négociation de contenu HTTP (Accept: text/markdown) ou directement via /api/md/{chemin}.

curl -H 'Accept: text/markdown' https://www.banklabs.fr/banques/boursobank-avis-tarifs
curl https://www.banklabs.fr/api/md/banques/boursobank-avis-tarifs

Catalogue & spécification

MCP (protocole MCP)

Banklabs expose un serveur MCP en transport HTTP diffusable en flux sur /api/mcp. La carte de serveur (SEP-1649) est publiée sur /.well-known/mcp/server-card.json. Méthodes JSON-RPC supportées : initialize, tools/list, tools/call, ping. Les 11 outils ci-dessous sont en lecture seule et ne demandent ni compte, ni clé d'API (détails sur la page Sécurité et conformité).

  • get_page_markdown : Renvoie en Markdown une page publique de Banklabs (accueil, fiche banque, comparatif, guide).
  • list_banks : Liste les banques suivies par Banklabs avec l’adresse de leur fiche.
  • compare_banks : Renvoie en Markdown la page de comparaison de deux ou trois banques.
  • get_fees_barometer : Renvoie une édition archivée du baromètre des frais bancaires, avec sources, dates de collecte et limites.
  • get_bank_fees : Renvoie la fiche tarifaire structurée d’une banque, avec la source et la date de collecte.
  • get_coverage : Indique ce que Banklabs sait et ne sait pas pour une banque : données documentées, sources, manques et contradictions.
  • get_evidence : Renvoie la preuve d’une valeur : source, date d’effet, date de collecte et extrait du document.
  • get_fee_history : Renvoie l’historique d’un frais pour une banque, avec la valeur en vigueur à une date donnée si demandé.
  • get_tariff_changes : Liste les changements de tarifs détectés entre deux éditions d’une même source.
  • get_promotions : Liste les primes de bienvenue observées par banque et par offre, avec leur historique.
  • compare_annual_cost : Estime le coût annuel de plusieurs banques pour un profil d’usage explicite, sans compter les postes inconnus à 0 €.

OAuth / OIDC

Les documents de découverte OAuth 2.0 (RFC 8414) et OpenID Connect sont publiés afin que les agents puissent découvrir les points d'authentification. L'autorisation client_credentials est déclarée mais aucun client n'est provisionné par défaut : l'endpoint /oauth/token renvoie invalid_client tant qu'un secret n'est pas configuré. Les APIs publiques (Markdown, MCP, statut) ne nécessitent pas d'inscription : voir /auth.md.

Plan du site et robots

Retour à l'accueil