agentleFS
enzobleuzeenzobleuze/machine-claude/.claude/skills/distribution-api/SKILL.md

distribution-api

Skill2 starsChanged 20 days agoMITView on GitHub

Publie et programme le contenu partout par API (un CRM multi-réseaux comme GoHighLevel, ou Buffer, Metricool, les API natives) au lieu de copier-coller à la main : brouillons, programmation, vidéo YouTube, podcast. Utiliser quand l'utilisateur dit « publie partout », « programme mes posts », « distribue ma vidéo ». Pas pour écrire le contenu (utiliser le skill de la pièce).

The file

Files
SKILL.md

Distribution par API

Pourquoi

Au début du système d'origine, chaque post demandait plusieurs clics par réseau et par jour : intenable, donc rien ne sortait. Le passage à un CRM qui publie sur plusieurs réseaux par une seule API a tout changé : Claude programme, l'entrepreneur garde un délai pour relire et supprimer, et sans action de sa part le post part seul. Les réseaux ont chacun leurs pièges (une vidéo refusée si elle vient d'un domaine inconnu, une limite d'images, un carrousel qui exige une vidéo) : ils sont notés une fois et gérés dans le code.

Prérequis

  • Des pièces validées par le board (board-textes, bloc C). Rien ne se programme sans verdict vert.
  • Un outil de publication au choix : GoHighLevel (Social Planner), Buffer, Metricool, ou les API natives (YouTube Data API, Meta Graph API pour Instagram, Facebook et Threads).
  • Bloc A : l'endroit des secrets (clé d'API hors du vault et hors de Git).
  • Python 3.

Interview

Lis d'abord : wiki/maps/machine-contenu.md (réseaux, cadence), les outils déjà payés dans wiki/maps/moi.md. Puis demande :

  1. « As-tu déjà un outil qui publie sur plusieurs réseaux ? » Si non, présente les options et leurs coûts, il choisit. Range dans wiki/maps/distribution.md, section « Outil ».
  2. « Quels comptes sont branchés dedans ? » Il les connecte lui-même (connexions OAuth). Guide-le clic par clic dans l'interface de l'outil.
  3. « Tu veux un délai de relecture avant que ça parte ? Combien d'heures ? » Range dans « Règles ».
  4. « Tu veux un podcast audio de tes vidéos ? » Si oui, l'étape 5 s'ajoute.

Construire

  1. La clé (l'utilisateur, 5 min). Il crée une clé d'API dans son outil (GoHighLevel : Paramètres, Clés API privées, avec les droits sur les réseaux sociaux). Il la colle dans le fichier de secrets du bloc A, jamais dans une conversation partagée ni dans le vault.
  2. Les comptes (Claude, 10 min). Liste les comptes branchés par l'API (GoHighLevel : GET https://services.leadconnectorhq.com/social-media-posting/<locationId>/accounts, en-têtes Authorization: Bearer <clé> et Version: 2021-07-28). Écris la table réseau vers identifiant de compte dans wiki/maps/distribution.md.
  3. Le script de publication (Claude, 20 min). outils/publier.py lit une file (outputs/file-publication/AAAA-MM-JJ.json : réseau, texte, médias, date), contrôle chaque entrée (verdict du board présent, longueur par réseau, lien en première réponse là où il pénalise), puis programme. Par défaut il tourne à blanc et affiche ce qu'il ferait ; --live envoie. Il écrit un journal (envoyé, refusé, raison) et ne renvoie jamais une entrée déjà envoyée.
  4. Le premier envoi (Claude puis l'utilisateur). Un seul post, sur un seul réseau, en brouillon ou programmé à plus tard. L'utilisateur le voit dans l'outil. Ensuite seulement, la file complète.
  5. Vidéo longue et podcast (Claude, 20 min, option). YouTube : envoi par l'API YouTube Data (titre, description, chapitres, miniature, programmé) ou par l'outil multi-réseaux. Podcast : extrais l'audio (ffmpeg -i video.mp4 -vn -c:a libmp3lame -b:a 128k episode.mp3), publie un flux RSS que tu possèdes (un stockage public plus un fichier XML), puis l'utilisateur soumet le flux une fois aux annuaires (Apple Podcasts, Spotify, Deezer, Amazon Music). L'épisode s'ouvre sur l'accroche, sans salutation.
  6. La tâche (Claude, 10 min). Une tâche planifiée (bloc F) vide la file à heure fixe, avec un résumé au rapport du matin. Une alerte seulement si l'outil se déconnecte.

Test

Un post programmé par le script apparaît dans l'outil sur le bon réseau à la bonne heure, et le journal montre la même entrée refusée au deuxième passage.

Pièges vécus

  • Les validations manuelles « en revue » sur chaque réseau : trop de clics, abandon. Programme avec un délai de relecture et laisse partir.
  • Une vidéo refusée parce qu'elle était hébergée sur un domaine non vérifié : envoie d'abord le fichier dans la médiathèque de l'outil.
  • Un réseau qui limite le nombre d'images, un autre qui refuse un carrousel sans vidéo : écris ces limites dans la table des comptes.
  • Une tâche planifiée expirée qui a coupé la publication plusieurs jours sans bruit : le gardien du bloc F surveille la file.
  • Les gestes qu'aucune API ne fait (épingler un commentaire, écran de fin YouTube, test de miniatures) : liste-les dans la feuille du jour J.

Entretien dans le temps

Le journal de publication se lit chaque semaine avec mesure-et-apprentissage. Chaque nouveau refus d'un réseau devient une règle dans le script. Revois les connexions OAuth quand l'outil prévient d'une expiration.

Après

Mets à jour wiki/maps/parcours.md, log.md, la mémoire (outil choisi, délai de relecture). Propose ensuite images-de-marque.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.