Agents · MCP + API
Connectez votre agent à Hookbird
Un serveur MCP, une API. Votre agent peut lire votre marque, écrire et noter des accroches, générer des posts dans Studio (il annonce d’abord le prix en crédits) et les programmer sur vos canaux.
URL du serveur MCP (connexion OAuth)
https://app.hookbird.ai/mcp-oauth-dynamic$
Claude Code
MCPAjoutez Hookbird comme serveur MCP distant, puis connectez-vous une fois dans le navigateur. Vous préférez une clé ? Hookbird → Agents donne la commande avec la clé dans l’en-tête.
- 1Lancez la commande dans votre terminal
- 2Tapez /mcp dans Claude Code, choisissez hookbird et connectez-vous
claude mcp add --transport http hookbird https://app.hookbird.ai/mcp-oauth-dynamicClaude (bureau et web)
ConnecteurAjoutez un connecteur personnalisé avec l’URL MCP de Hookbird.
- 1Paramètres → Connecteurs → Ajouter un connecteur personnalisé
- 2Nommez-le Hookbird et collez l’URL
- 3Cliquez sur Connecter et autorisez l’accès
https://app.hookbird.ai/mcp-oauth-dynamicChatGPT
ConnecteurUtilisez l’URL du connecteur dans le mode développeur de ChatGPT.
- 1Paramètres → Applications et connecteurs → Paramètres avancés → Mode développeur
- 2Créez un connecteur, collez l’URL, authentification : OAuth
- 3Activez-le dans une conversation depuis le menu +
https://app.hookbird.ai/mcp-oauth-dynamicOpenClaw
MCPEnregistrez le serveur et connectez-vous : votre claw reçoit les outils Hookbird. Une skill Hookbird prête à l’emploi lui apprend la marche à suivre.
- 1Lancez les deux commandes
- 2Demandez : « écris 5 accroches pour ma marque et note-les »
openclaw mcp add hookbird --url https://app.hookbird.ai/mcp-oauth-dynamic --transport streamable-http --auth oauth
openclaw mcp login hookbirdHermes Agent
MCPAjoutez Hookbird à votre config Hermes, avec la skill Hookbird pour la marche à suivre.
- 1Ajoutez-le à ~/.hermes/config.yaml
- 2Lancez hermes mcp login hookbird, puis /reload-mcp dans la conversation
# ~/.hermes/config.yaml
mcp_servers:
hookbird:
url: "https://app.hookbird.ai/mcp-oauth-dynamic"
auth: oauthGrok (API xAI)
MCPPassez Hookbird comme outil MCP distant dans une requête à l’API Responses de xAI. Grok appelle les outils côté serveur.
- 1Copiez votre clé API depuis Hookbird → Agents
- 2Ajoutez l’outil à votre requête
{
"model": "grok-4.7",
"input": "Score this hook: POV: 11pm, your accountant wants 43 receipts",
"tools": [
{
"type": "mcp",
"server_label": "hookbird",
"server_url": "https://app.hookbird.ai/api/mcp",
"headers": {
"Authorization": "Bearer $HOOKBIRD_API_KEY"
}
}
]
}API publique et SDK Node
APIDu HTTPS et du JSON : notez et écrivez des accroches, lisez la marque, lancez Studio, programmez des posts. Ou npm i @hookbird/node.
- 1Copiez votre clé API depuis Hookbird → Agents
- 2Envoyez-la dans l’en-tête Authorization
curl -X POST https://app.hookbird.ai/api/public/v1/hooks/score \
-H "Authorization: $HOOKBIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"POV: 11pm, your accountant wants 43 receipts"}'Ce que votre agent peut faire
Ce sont les noms d’outils que voit votre agent. Chaque post attend toujours votre confirmation.
hookbird.brand_profileLire la marque : ton, produits, audiences, concurrents. brand_read la construit à partir d’une URL.
hookbird.hooks_generateÉcrire des accroches pour un sujet et une audience, chacune notée de 0 à 100, la meilleure en premier.
hookbird.hooks_scoreNoter votre propre accroche, avec ses points forts, ce qu’il faut corriger et une version plus forte.
hookbird.studio_generateCréer l’un des 28 formats : vidéo UGC, vidéo explicative, diaporama, story, pub statique. Choisir la voix, le cadrage, la qualité et les effets. studio_formats affiche d’abord le prix.
hookbird.strategy_planPlanifier des semaines de posts : dates, canaux, formats, accroches, en brouillons dans le calendrier.
hookbird.radar_adsLes pubs concurrentes et depuis combien de temps elles tournent. radar_trends : hashtags, sons, créateurs.
hookbird.benchmarksVos 30 derniers jours face à la médiane et au top 10 % de votre niche, avec les sources.
hookbird.credits_balanceLes crédits restants. Accroches, marque, plans et recherche sont gratuits. Seul Studio consomme des crédits.
hookbird.integrationSchedulePostToolProgrammer un post, ou le mettre en brouillon, sur n’importe quel canal connecté, après votre confirmation.