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-tarifsCatalogue & spécification
- Catalogue ARD (agents) : /.well-known/ai-catalog.json :
application/json. - Catalogue (RFC 9727) : /.well-known/api-catalog :
application/linkset+json. - OpenAPI 3.1 : /.well-known/openapi.json.
- Statut : /api/status (JSON).
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.
- Fichier d'inscription agents : /auth.md
- Serveur d'autorisation : /.well-known/oauth-authorization-server
- Configuration OpenID Connect : /.well-known/openid-configuration
- Ressource protégée (RFC 9728) : /.well-known/oauth-protected-resource
- JWKS : /oauth/jwks
Plan du site et robots
- Fichiers plan du site : plan du site principal · plan du site actualités.
- Préférences IA pour les robots : /robots.txt.