Pour les développeurs & vibe coders

Livrez de la vidéo depuis votre terminal.

Votre agent écrit la pub. Vous postez le MP4.

Branchez le MCP Hubfluencer sur votre agent de code et transformez un seul prompt en pub finie, prête à poster — ou apportez vos rushes, photos produit et logo pour que l'agent les monte. Les crédits et jetons d'accès restent dans l'app ; l'agent, lui, fabrique la vidéo, en général en quelques minutes.

Obtenir un jeton d'accès Voir l'API REST

Les jetons vivent dans l'app web sous Settings → Access tokens. Crédits prépayés à 0,99 $ pièce — moins cher en volume — et les brouillons sont gratuits. L'agent annonce le prix et demande avant de dépenser.

agent session 
# You type
> Use Hubfluencer to make a 15s ad for my candle brand.

# Your agent calls
make_video({ prompt: "...", save_path: "./candle-ad.mp4" })

# You get back
→ { slug: "...", ready: true,
    video_url: "https://...mp4 (presigned, ~24h)",
    saved_to: "./candle-ad.mp4" }
Un vrai rendu — un seul prompt, aucun éditeur ouvert. Le vôtre arrive en MP4 propre, prêt à poster.

Comment ça marche

Trois étapes. Un prompt. Un MP4.

Connectez votre compte

Créez votre compte sur app.hubfluencer.com and generate an access token (Settings → Access tokens, Generate videos scope) — or skip the copy-paste and run npx -y @hubfluencer/mcp@0.18.0 login.

Brouillons et planification gratuits — achetez des crédits (0,99 $ pièce, moins cher en volume) quand vous êtes prêt à générer.

Ajoutez le MCP

Enregistrez le serveur MCP Hubfluencer auprès de votre agent — une commande ou un petit bout de config. Choisissez votre outil dans le Démarrage rapide ci-dessous.

npx -y @hubfluencer/mcp@0.18.0 --profile creator

Le profil creator garde visibles les outils de haut niveau pour créer, récupérer et livrer, afin que votre agent consacre moins de contexte à leur découverte. Les configurations existantes restent par défaut sur le profil full.

Promptez votre agent

Dites « Utilise Hubfluencer pour faire une pub de 15 s pour ma marque de bougies » et récupérez un MP4.

Les brouillons sont gratuits. Un short se génère pour 15 crédits (≈ 15 $ max), une pub editor 5 scènes pour ~28 (≈ 28 $ max) — votre agent confirme d'abord le prix avec vous, et la plupart des rendus se terminent en quelques minutes.

Démarrage rapide

Branchez-le sur votre agent.

Choisissez votre outil. Chaque kit enregistre le même serveur @hubfluencer/mcp et fournit un skill concis chargé à la demande. Le MCP donne les outils à votre agent ; le skill lui apprend l'approbation des dépenses et les règles du cycle de vie, puis ne charge son guide avancé qu'en cas de besoin.

After connecting, run npx -y @hubfluencer/mcp@0.18.0 doctor --profile creator. It verifies credentials, the secure API origin, credits access, tool profile, and local-file boundaries without spending credits.

Ajoutez le MCP — une seule commande

terminal 
claude mcp add --transport stdio --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN hubfluencer -- npx -y @hubfluencer/mcp@0.18.0 --profile creator

Collez-la dans votre shell — pas dans une session Claude en cours, où elle serait lue comme un prompt au lieu d'être exécutée. Tous les flags vont avant le nom du serveur ; -- le sépare de la commande que Claude Code lance. Utilisez --scope project pour écrire le serveur dans .mcp.json à la racine du repo.

…ou un fichier de config

.mcp.json 
{
  "mcpServers": {
    "hubfluencer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@0.18.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}

Formez l'agent

Installez le skill complet à la demande en une commande. Ajoutez --project pour utiliser .claude/skills au lieu de votre répertoire de skills personnel.

npx -y @hubfluencer/mcp@0.18.0 install-skill --client claude-code

Télécharger le kit

SKILL.md API.md advanced guide README.md
Connect first: create a Generate-videos-scope token in the app and export it as HUBFLUENCER_API_TOKEN, or run npx -y @hubfluencer/mcp@0.18.0 login. Never paste a token into a committed file — use ${HUBFLUENCER_API_TOKEN} expansion.

Ajoutez le MCP — une seule commande

terminal 
codex mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hubfluencer/mcp@0.18.0 --profile creator

…ou un fichier de config

~/.codex/config.toml 
[mcp_servers.hubfluencer]
command = "npx"
args = ["-y", "@hubfluencer/mcp@0.18.0", "--profile", "creator"]

[mcp_servers.hubfluencer.env]
HUBFLUENCER_API_TOKEN = "YOUR_TOKEN"
# Optional:
# HUBFLUENCER_BASE_URL = "https://hubfluencer.com"
# HUBFLUENCER_OUTPUT_DIR = "/absolute/path/where/mp4s/may/be/written"

Redémarrez Codex après avoir modifié config.toml. Gérez avec codex mcp list / get / remove.

Formez l'agent

Installez le skill complet dans le répertoire natif partagé de Codex ~/.agents/skills/hubfluencer-create. Ajoutez --project pour utiliser .agents/skills/hubfluencer-create dans le projet courant. AGENTS.md n'est désormais qu'un court pointeur facultatif.

npx -y @hubfluencer/mcp@0.18.0 install-skill --client codex

Télécharger le kit

SKILL.md AGENTS.md advanced guide README.md
Connect first: create a Generate-videos-scope token in the app, or run npx -y @hubfluencer/mcp@0.18.0 login. If you logged in, omit the env block entirely — the server reads the saved token automatically.

Ajoutez le MCP — config uniquement

OpenCode n'a pas de commande mcp add. Éditez la config JSON à la main. Attention : type vaut local (pas stdio), et la clé est environment (pas env).

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hubfluencer": {
      "type": "local",
      "command": ["npx", "-y", "@hubfluencer/mcp@0.18.0", "--profile", "creator"],
      "enabled": true,
      "environment": {
        "HUBFLUENCER_API_TOKEN": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

À placer dans opencode.json (racine du projet) ou ~/.config/opencode/opencode.json. Redémarrez OpenCode après modification.

Formez l'agent

Utilisez le répertoire natif de skills à la demande d'OpenCode au lieu de placer tout le workflow dans AGENTS.md chargé en permanence. Ajoutez --project pour .opencode/skills.

npx -y @hubfluencer/mcp@0.18.0 install-skill --client opencode

Télécharger le kit

SKILL.md AGENTS.md advanced guide README.md
Connect first: paste a Generate-videos-scope token as HUBFLUENCER_API_TOKEN in the environment block, or run npx -y @hubfluencer/mcp@0.18.0 login and drop the block entirely.

Ajoutez le support MCP, puis le serveur

Pi n'a pas de MCP natif — installez l'extension pi-mcp-adapter, puis déposez une config mcp.json.

terminal 
pi install npm:pi-mcp-adapter
~/.pi/agent/mcp.json 
{
  "mcpServers": {
    "hubfluencer": {
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@0.18.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}
Attention : le support MCP de Pi vient d'une extension communautaire, pas d'une fonctionnalité officielle — les noms de champs de l'adaptateur peuvent bouger d'une version à l'autre, vérifiez donc le README de pi-mcp-adapter. L'alternative 100 % native : livrer une Skill Pi qui pilote l'API REST en bash + curl.

Formez l'agent

Installez ensemble le skill concis et sa référence avancée. Ajoutez --project pour .pi/skills ; AGENTS.md n'est qu'un court pointeur facultatif.

npx -y @hubfluencer/mcp@0.18.0 install-skill --client pi

Télécharger le kit

SKILL.md AGENTS.md advanced guide mcp.json README.md

Une même config, plein de clients

Cursor, Windsurf, Claude Desktop et la plupart des autres clients MCP acceptent le même bloc mcpServers :

mcp servers config 
{
  "mcpServers": {
    "hubfluencer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@0.18.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}
  • Cursor — .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json en global.
  • Windsurf — ~/.codeium/windsurf/mcp_config.json
  • Claude Desktop — claude_desktop_config.json via Réglages → Développeur → Modifier la config.

Les noms de champs varient parfois selon les clients (env vs environment) — consultez la doc MCP de votre outil si le serveur n'apparaît pas.

Formez l'agent

Récupérez les instructions en Markdown brut et déposez-les là où votre outil lit ses consignes — fichier de règles, notes de projet ou prompt système. API.md est la même référence que consultent les skills.

Télécharger le kit

AGENTS.md API.md
Connect first: create a Generate-videos-scope token in the app and reference it as ${HUBFLUENCER_API_TOKEN}, or run npx -y @hubfluencer/mcp@0.18.0 login and drop the env block entirely.

Référence des outils

Ce que l'agent peut appeler.

Outil Ce que ça fait Crédits
make_video En un appel : prompt en entrée, MP4 fini en sortie. Crée, génère, polle et télécharge. 15+
create_short Créer un brouillon de short à partir d'un prompt. 0
generate_short Générer un brouillon de short. 15
create_editor_ad Créer un brouillon de pub editor multi-scènes pour les prompts narratifs. 0
cancel_autopilot Stop exactly the Autopilot attempt observed in generation_summary; the tool forwards its run/start fence and keeps completed work. 0
cancel_segment_generation Cancel one individually generated scene with its claim token and refund its charge. refund
upload_video Uploadez votre propre clip vidéo et déposez-le sur la timeline comme scène. 0
set_product Attach a product photo as the identity reference for every generated AI scene; its description grounds the story and the exact image becomes the closing shot unless you set another. 0
set_logo Incruster votre logo sur la vidéo finie. 0
set_closing_image Définir une image de fin personnalisée — uploadez-en une ou réutilisez la photo produit. 0
get_status Check current status, including real per-clip progress while a paid short renders. 0
wait_for_completion Poller jusqu'à la fin du rendu ; rappelez-le s'il expire en cours d'attente. 0
download_result Télécharger le MP4 fini depuis son URL présignée (~24 h). 0
list_renders List every render version with status, download/thumbnail URLs, duration, freshness, and retryability. 0
retry_render Relancer un rendu échoué depuis son instantané sauvegardé. 0
list_voices List voice-over voices and their verified languages. 0
get_credits Lire le solde de crédits avant de dépenser. 0
list_projects Lister les projets vidéo récents du compte. 0

make_video est la voie en un appel. Un rendu de short coûte 15 crédits ; une pub editor 5 scènes ~28 (le crédit est à 0,99 $, moins cher en volume) — vérifiez le chiffre exact avec GET /api/editor/:slug/autopilot/cost, ou passez dry_run pour chiffrer un job gratuitement.

Apporter vos propres médias est gratuit : upload_video dépose vos rushes sur la timeline, et set_product / set_logo / set_closing_image ajoutent votre marque. Au-delà de cette sélection, le MCP expose aussi l'éditeur granulaire complet — scénario, prompts par scène, narration, voix et musique — pour que l'agent dirige une pub de bout en bout. Voir la liste des outils @hubfluencer/mcp pour tout le détail.

Au-delà d'une vidéo

Votre agent fait tourner toute l'opération contenu.

Donnez-lui une page produit et il peut planifier une campagne, préparer un lot de pubs, recueillir la validation d'un client et monter le calendrier de publication — le même MCP couvre chaque étape.

Planifier

extract_product_page transforme une URL en faits et visuels ; plan_campaign et generate_hook_variations transforment ces faits en hooks, angles et scripts — chacun avec une estimation en crédits.

Préparer

Matérialisez les hooks qui vous plaisent en brouillons éditables — pubs multi-scènes, shorts ou carrousels d'images — regroupés en packs de campagne, avec des séries pour les formats récurrents.

Valider

create_review_link crée une URL à durée limitée, accessible sans compte, où un client approuve ou demande des retouches — avant que vous ne dépensiez des crédits sur le lot suivant.

Programmer

schedule_post monte un calendrier de rappels ; vous postez, l'agent marque l'étape faite. La publication automatique vers TikTok/Instagram reste sous contrôle humain dans l'app.

Planification et brouillons gratuits (20 assists IA par jour) ; seul le rendu dépense des crédits. Le MCP couvre la même surface que la référence REST — carrousels, overlays de tracking, profils de marque et notes de performance compris.

Auth & crédits

Crédits prépayés, jetons scopés.

Vous achetez des crédits et créez des jetons d'accès dans l'app — 0,99 $ le crédit, moins cher en volume. Rien de crypto ici — juste un solde et un jeton Bearer. L'agent annonce le coût et demande avant de dépenser ; vous gardez la main.

Jetons d'accès

Créés dans l'app sous Settings → Access tokens. Le scope agent s'appelle « Generate videos » = video:generate + video:read. Les jetons d'agent n'obtiennent jamais account:admin.

Variables d'environnement lues par le serveur :

  • HUBFLUENCER_API_TOKEN — requis (sauf connexion via login)
  • HUBFLUENCER_BASE_URL — optionnel, par défaut https://hubfluencer.com
  • HUBFLUENCER_OUTPUT_DIR — optionnel, restreint où les MP4 peuvent être écrits

Connexion sans copier-coller

Run npx -y @hubfluencer/mcp@0.18.0 login. It prints a URL and a short code; you approve the connection in the signed-in app. A scoped token is saved to ~/.hubfluencer/credentials.json et le serveur le récupère automatiquement — vous pouvez donc omettre complètement HUBFLUENCER_API_TOKEN.

terminal 
npx -y @hubfluencer/mcp@0.18.0 login

L'agent n'invente jamais de jeton et n'en affiche jamais dans sa sortie.

Gestion des échecs

  • 402 — credits_insufficient : indiquer requis vs disponible, puis s'arrêter (pas de boucle).
  • 409 — déjà en cours : continuez de poller, ne relancez pas.
  • 403 — insufficient_scope : le jeton n'a pas video:generate.
  • Relances : envoyez une Idempotency-Key sur les appels generate pour qu'une relance ne facture pas deux fois.

Crédits

  • Brouillons & planification — gratuits (plus 20 assists IA/jour)
  • Générer un short — 15 crédits (≈ 15 $ max)
  • Pub editor 5 scènes — ~28 crédits (≈ 28 $ max ; vérifiez le coût exact en amont)

Un crédit coûte 0,99 $, moins cher en volume — prépayé dans l'app. Les skills exigent que l'agent annonce le coût et obtienne votre accord avant de dépenser.

Hors périmètre

Publier sur TikTok / Instagram exige un compte social lié par un humain. L'agent ne publie jamais tout seul — il rend le MP4 fini plus une légende prête à coller, et vous postez vous-même.

REST direct — sans MCP

Vous préférez du HTTP brut ? Allez-y.

L'URL de base est https://hubfluencer.com, tout vit sous /api, et vous vous authentifiez avec Authorization: Bearer <token>. Trois requêtes font passer un short du prompt au MP4 : créez le brouillon, lancez le rendu, puis suivez le timing et les actions disponibles de generation_summary jusqu'à ce que download_result soit proposé.

Lire la référence API.

Chaque endpoint externe, avec paramètres et exemples de réponses — aucun jeton requis pour la lire. La spec OpenAPI brute y est aussi liée.

Pour Editor et Short, generation_summary fait autorité sur le cycle de vie : suivez generation_summary.timing.poll_after_ms, n'invoquez que generation_summary.available_actions et n'utilisez les projections produit que comme affichage ou barrières de route explicites. Ne récupérez l'asset que lorsque download_result est proposé.

shorts.sh 
# 1. Create the draft (0 credits) — response includes the slug
curl -X POST https://hubfluencer.com/api/shorts \
  -H "Authorization: Bearer $HUBFLUENCER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_prompt": "15s ad for my candle brand"}'

# 2. Start the render (15 credits) — the Idempotency-Key makes retries safe
curl -X POST https://hubfluencer.com/api/shorts/SLUG/generate \
  -H "Authorization: Bearer $HUBFLUENCER_API_TOKEN" \
  -H "Idempotency-Key: gen-short:SLUG"

# 3. Follow generation_summary.timing.poll_after_ms while positive.
# Stop when it is null; download only when available_actions includes download_result.
curl https://hubfluencer.com/api/shorts/SLUG \
  -H "Authorization: Bearer $HUBFLUENCER_API_TOKEN"

FAQ

Questions, réponses.

Combien de temps prend un rendu ?

Quelques minutes pour la plupart des shorts ; les runs autopilot multi-scènes peuvent durer plus longtemps. Ne pollez que tant que generation_summary.timing.poll_after_ms est positif, en respectant exactement la cadence du serveur ; null signifie qu'il faut arrêter et suivre une action proposée.

Combien coûte une vidéo en argent réel ?

Un crédit coûte 0,99 $ — moins cher en volume (packs et abonnements). Un short, c'est 15 crédits (jusqu'à ~15 $), une pub editor 5 scènes ~28 (jusqu'à ~28 $) — les brouillons, la planification et 20 assists IA par jour sont gratuits, et les skills demandent à votre agent de confirmer le prix avec vous avant tout rendu.

Filigranes ou restrictions d'usage ?

Aucun filigrane — le MP4 téléchargé est l'asset final, prêt à poster. Vous gardez les droits sur tout ce que vous uploadez.

Puis-je le lancer en headless — CI, cron, un bot ?

Oui. L'auth est un simple jeton Bearer en variable d'environnement, tout est du REST en dessous, et le serveur MCP est un process npx sans état — tout ce qui parle MCP ou HTTP fonctionne.

Où trouver de l'aide ?

Le Discord est le canal le plus rapide — sinon, écrivez à contact@hubfluencer.com. Les rapports de bugs et demandes de fonctionnalités sur les kits MCP sont particulièrement bienvenus.