← Accueil

C3DB

Interrogez l'entrepôt de données d'escalade de compétition depuis votre navigateur, votre terminal ou votre propre IA.

Interroger dans le navigateur

Un espace navigateur pour le SQL et les requêtes en langage naturel. Rien à installer.

Ouvrir la console web →

1. Exécuter du SQL

Installez le client, connectez-vous une fois, puis envoyez du SQL en lecture seule. Vous recevez un tableau.

pip install c3db
c3db login
c3db query "SELECT * FROM event_standings WHERE final_rank = 1 LIMIT 5"
Créer ou gérer des clés dans le navigateur →

2. L'utiliser dans ChatGPT, Gemini ou Claude

Rien à installer, aucune clé à copier. Vous ajoutez une adresse dans l'application, vous vous connectez à C3DB quand elle le demande, puis vous posez vos questions en langage courant. L'application lit la structure de la base et écrit le SQL à votre place.

L'adresse à coller :

https://c3db-mcp-rt24zk2pna-uc.a.run.app/mcp

Il vous faut un compte C3DB gratuit. Une page de connexion s'ouvre au cours des étapes ci-dessous ; créez-y le compte si vous n'en avez pas.

Claude, sur claude.ai

  1. Ouvrez claude.ai et connectez-vous.
  2. Cliquez sur votre nom en bas à gauche, puis Settings, puis Connectors.
  3. Cliquez sur Add custom connector.
  4. Collez l'adresse ci-dessus dans le champ URL, puis cliquez sur Add.
  5. Cliquez sur Connect à côté de C3DB, connectez-vous à C3DB, puis cliquez sur Allow.
  6. Dans une conversation, cliquez sur le bouton +, ouvrez Connectors et activez C3DB.

Sur les forfaits Team et Enterprise, un propriétaire ajoute d'abord le connecteur dans Admin settings, puis chacun clique sur Connect.

ChatGPT, sur chatgpt.com

  1. Ouvrez chatgpt.com et connectez-vous.
  2. Ouvrez Settings, puis Connectors, puis Advanced, et activez Developer mode.
  3. Revenez dans Connectors et cliquez sur Create.
  4. Nommez-le C3DB, collez l'adresse ci-dessus comme server URL, puis cliquez sur Create.
  5. Connectez-vous à C3DB, puis cliquez sur Allow.
  6. Dans une nouvelle conversation, cliquez sur +, puis More, puis Developer mode, et activez C3DB.

Developer mode exige un forfait payant (Pro, Business, Enterprise ou Edu). Le connecteur doit être activé dans chaque nouvelle conversation.

Gemini, sur gemini.google.com

  1. Ouvrez gemini.google.com et connectez-vous avec un compte Google personnel.
  2. En bas, ouvrez Settings & help, puis Connected Apps. Si vous ne le voyez pas, ouvrez d'abord Personal Intelligence.
  3. Sous Custom apps for Spark, cliquez sur Add a custom app.
  4. Collez l'adresse ci-dessus, puis cliquez sur Next.
  5. Connectez-vous à C3DB, puis cliquez sur Allow.
  6. Dans une invite, tapez @ et choisissez C3DB pour que Gemini l'utilise.

Google réserve cela aux utilisateurs de Gemini Spark de 18 ans ou plus, aux États-Unis, sur un compte personnel, avec Keep Activity activé.

3. L'utiliser dans un agent de code

Une commande enregistre l'entrepôt dans Claude Code ou Cursor. Votre agent lit le schéma et écrit le SQL lui-même, aucune clé de modèle n'est requise. Installez d'abord le client, comme à l'étape 1.

c3db connect claude
c3db connect cursor

Claude Code et Cursor pris en charge. Codex bientôt.

4. Si rien de tout cela ne marche : c3db ask

Votre propre modèle écrit le SQL et C3DB l'exécute. Claude utilise votre connexion `ant auth login` ; pour OpenAI, DeepSeek ou GLM, définissez une clé de fournisseur ou lancez `c3db model set <provider>`.

pip install "c3db[ask]"
c3db ask "who has the most World Cup golds in lead?"

🔒 Votre clé API de modèle reste sur votre machine (variable d'environnement ou ~/.config/c3db). Elle n'est jamais envoyée à C3DB.

SDK Python

Client().query() renvoie un DataFrame pandas ; Client().ask() laisse votre propre modèle écrire le SQL.

from c3db import Client

df = Client().query("SELECT athlete_name, count(*) AS golds "
                    "FROM event_standings WHERE final_rank = 1 "
                    "GROUP BY 1 ORDER BY 2 DESC")

# or let your own model write the SQL:
df = Client().ask("who has the most World Cup golds in lead?")

Commandes

CommandeRôle
c3db loginVérifie et stocke votre clé de données C3DB.
c3db query "<sql>"Exécute une requête SQL en lecture seule (-f fichier / stdin ; --format table|csv|json).
c3db ask "<question>"Posez une question en langage naturel ; votre propre modèle écrit le SQL. Nécessite pip install "c3db[ask]".
c3db connect claudeEnregistre le MCP hébergé dans Claude Code ou Cursor.
c3db schemaAffiche les conventions de requête et le DDL BigQuery de référence.