---
name: bumpi
description: Pilote Bumpi (studio de contenu on-brand) depuis Claude via MCP — importe une marque depuis son URL, propose des directions créatives, génère images/vidéos/déclinaisons alignées sur l'identité mesurée de la marque. À utiliser dès que l'utilisateur veut créer du contenu marketing visuel pour une marque.
---

# Bumpi — studio de contenu on-brand, piloté depuis Claude

Bumpi mesure l'identité d'une marque depuis son site (couleurs quantifiées au
pixel sur de vraies captures, ton, positionnement, garde-fous), la verrouille,
puis l'injecte dans chaque génération. Tu pilotes tout via les tools MCP du
connecteur `bumpi`.

## Prérequis (une fois)

L'utilisateur ajoute le connecteur MCP :

```bash
claude mcp add --transport http bumpi https://bumpi.nuva.be/api/mcp \
  --header "X-OpenRouter-Key: bumpi_sk_…"
```

La clé `bumpi_sk_…` se crée sur https://bumpi.nuva.be/account (section
« Clés API »). Chaque génération consomme les crédits du compte — une réponse
402 signifie « plus de crédits » : renvoie l'utilisateur vers
https://bumpi.nuva.be/pricing, ne réessaie pas en boucle.

## La règle d'or : proposer, jamais imposer

Bumpi est un *helper*, pas une boîte noire. Avant TOUTE génération payante :

1. Montre ce que tu as compris (marque + brief).
2. Propose 2-3 directions distinctes (via `propose-prompts`).
3. L'utilisateur choisit — ALORS SEULEMENT tu génères.

Le brief de l'utilisateur est autoritaire : n'invente jamais de prix, dates,
offres ou allégations qui n'y figurent pas.

## Workflow type

### 1. Importer la marque (une fois par marque)

- `extractBrand` avec l'URL du site → identité mesurée (couleurs réelles,
  ton, type d'activité). Montre le résultat à l'utilisateur et fais-le valider
  ou corriger avant de continuer.
- `brandIntelligence` pour l'analyse approfondie (positionnement, cible,
  différenciateurs) quand l'utilisateur veut un contexte riche.
- `brandVisualPreview` pour vérifier visuellement que la marque est bien captée.

### 2. Proposer des directions

- `suggest-orientations` : 4-6 pistes courtes à partir du brief.
- `propose-prompts` : 3 prompts complets et délibérément différents.
  Spécialistes disponibles via le champ `specialist` :
  - `image-art-direction` (défaut) — 3 directions artistiques image
  - `video-shots` — 3 découpages caméra/rythme pour la vidéo
  - `copy-overlay` — 3 accroches ≤ 6 mots à incruster sur le visuel
  - `localization` — 3 adaptations culturelles natives (champ `language`)

### 3. Générer

- Image : `promptFor` (compose le prompt final avec le contexte de marque)
  puis `generateImage`.
- Vidéo : `promptForVideo` puis `generateVideo` — **asynchrone** : la
  réponse contient un `id` ; interroge ensuite `getVideoStatus` avec cet
  `id` (toutes les 20-30 s) jusqu'à `status: "completed"` → `videoUrl`.
  Compte 1-3 minutes ; les crédits ne sont débités qu'à la complétion.
- Déclinaisons : `cropResizeImage` (recadrage exact multi-format 4:5, 1:1,
  9:16, 16:9) et `textOverlayImage` (texte incrusté au pixel — le texte est
  reproduit EXACTEMENT, jamais réécrit).
- Persona UGC : `personaFromUrl` depuis une URL produit.

### 4. Templates prêts à l'emploi

- `listTemplates` / `getTemplate` : workflows par métier (restaurant, SaaS,
  e-commerce…) — propose-les quand le besoin de l'utilisateur correspond à
  un cas connu plutôt que de repartir de zéro.

## Coûts (ordres de grandeur)

Une image ≈ 0,10 $, une vidéo ≈ 0,75-1,50 $, les appels d'aide au prompt
(propose/suggest/enhance) sont quasi gratuits. Annonce le coût approximatif
d'un pack avant de le générer (ex. « 3 images + 1 vidéo ≈ 2 $ de crédits »).

## Résultats

Chaque génération atterrit aussi dans la Library de l'utilisateur sur
https://bumpi.nuva.be/library — mentionne-le : il peut y rejouer le workflow
entier, l'éditer dans le canvas Studio, ou télécharger en un clic.