Communitygithub.com

Post to X (Publication sur X)

Publie un tweet ou un thread sur X/Twitter via l'interface web réelle (Playwright, sans API payante) — une compétence pour agents / Claude Code.

Qu'est-ce que Post to X (Publication sur X) ?

Cette compétence permet de publier des tweets ou des threads sur X/Twitter en automatisant le navigateur web réel (via Playwright et Chrome), sans utiliser l'API payante de X (supprimée en février 2026, pay-per-use : $0,015/post, $0,20 avec lien). L'utilisateur se connecte une seule fois manuellement, la session est persistée dans un profil Chrome dédié (~/.config/post-to-x/x-profile). La compétence supporte les tweets uniques, les threads (avec séparation automatique par marqueurs **N/M**, `---`, ou fichier entier), et l'attachement d'images (jusqu'à 4 par tweet). Un mode dry-run obligatoire permet de visualiser le thread dans le composeur X avant publication réelle, évitant les erreurs de sélecteurs ou de format. Idéale pour des publications à faible volume et rythme humain (annonces, threads de release), cette compétence est destinée aux agents comme Claude Code, Cursor ou Codex, et respecte les risques ToS en demandant toujours une validation explicite de l'utilisateur.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add Gamma-Software/post-to-x-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Post to X (Publication sur X) preview

Documentation

Que fait Post to X (Publication sur X) ?

Publie un tweet ou un thread sur X/Twitter en pilotant x.com dans un vrai navigateur, et non via l'API. X a supprimé l'API gratuite en février 2026 (pay-per-use : 0,015 $/post, 0,20 $ avec un lien). Cette compétence réutilise une session de navigateur que vous ouvrez une fois manuellement et publie via le site lui-même. Elle utilise le binaire Chrome réel + supprime les indicateurs d'automatisation pour passer la vérification « navigateur non fiable » de X.

Connexion unique (manuelle) → analyse texte/thread → composition en dry-run avec fenêtre → [OK utilisateur] → publication réelle

CGU + risque. La publication automatisée est contraire aux CGU de X et peut entraîner le signalement du compte. Cet outil est destiné à une auto-publication à faible volume et rythme humain — un thread de release, une mise à jour « build-in-public » — pas un robot de masse. Effectuez toujours un dry-run d'abord, conservez des délais humains, et ne publiez jamais au nom de l'utilisateur sans son accord explicite.

0. Configuration unique

Le script nécessite Playwright et Google Chrome installés (Chrome est le binaire de confiance ; Playwright fournit uniquement le pilote — pas de téléchargement de navigateur).

cd <dossier-du-skill> && npm install          # installe playwright dans le skill

Puis authentifiez-vous une fois — ouvre un vrai Chrome ; l'utilisateur se connecte manuellement (mot de passe + 2FA), la session persiste dans ~/.config/post-to-x/x-profile :

node scripts/post-x.mjs login

Si channel: "chrome" génère une erreur, Chrome n'est pas trouvé — installez Google Chrome (pas seulement Chromium). La fenêtre de connexion attend jusqu'à 5 minutes un état connecté.

1. Préparer le contenu

Accepte soit du texte en ligne, soit un fichier :

  • Tweet unique — --text "…".
  • Fichier thread — --file <chemin>. Les limites des tweets sont détectées automatiquement :
    1. Marqueurs **N/M** par tweet (style x-thread.md build-in-public), sinon
    2. tweets séparés par une ligne contenant uniquement ---, sinon
    3. aucun séparateur → tout le fichier est un tweet unique.
  • Images — par tweet, ajoutez une ligne _image: chemin_ ou ![](chemin) dans ce tweet ; ou attachez au premier tweet avec --image <chemin> répétable. X accepte jusqu'à 4 par tweet. Les chemins sont relatifs au fichier.
  • Supprimés automatiquement : citations > … (bannières DRAFT), titres # …, notes _(…caractères…)_.

Chaque tweet doit faire ≤ 280 caractères — le script affiche le nombre et signale tout dépassement.

2. Dry-run (étape obligatoire)

Toujours composer visiblement sans envoyer d'abord, pour que l'utilisateur voie le thread réel dans le composeur X :

node scripts/post-x.mjs post --file thread.md --headed --dry-run

Il tape chaque tweet dans la modale de composition (ajoute les posts du thread via le bouton "+"), attache les images, puis attend 30 s et ferme — rien n'est publié. Montrez à l'utilisateur ; obtenez un accord explicite.

3. Publier pour de vrai

Seulement après validation de l'utilisateur, retirez --dry-run :

node scripts/post-x.mjs post --file thread.md          # ou --text "…"
node scripts/post-x.mjs post --file thread.md --image shot.png --headed

--headed affiche le navigateur ; par défaut, headless. Le script clique sur « Tout publier » (thread) / « Publier » (tweet unique) et confirme la fermeture du composeur.

4. Valider

  • Vérification d'analyse — --parse-only affiche les tweets analysés + leur nombre de caractères + les chemins d'images et se termine. Exécutez-le quand le format du fichier n'est pas évident.
  • Vérification dry-run — la composition en mode headed ci-dessus est la véritable preuve qu'il publiera correctement ; l'ignorer a déjà expédié un thread cassé (sélecteurs ambigus, mauvaise division des tweets).
  • Vérification session — si le composeur ne se charge jamais, la session a expiré → relancez login.

5. Rapport

Informez l'utilisateur : nombre de tweets publiés (ou composés, pour un dry-run), tout tweet de plus de 280 caractères, images attachées, et le dossier de profil utilisé. Si un sélecteur a échoué, indiquez quelle étape et que l'interface de X a probablement changé (les data-testid dans post-x.mjssont la partie fragile).

Notes

  • Sélecteurs utilisés : tweetTextarea_<i>, addButton, fileInput, tweetButton — limités à la boîte de dialogue du composeur [role="dialog"]. Mettez-les à jour dans scripts/post-x.mjs si X refait le composeur.
  • La session se trouve dans ~/.config/post-to-x/x-profile (surchargeable avec --profile). Elle est en dehors du dépôt — ne la commitez jamais.
  • X uniquement ; LinkedIn/Mastodon/Bluesky ont des API gratuites — utilisez un planificateur (Postiz, Buffer, Typefully) pour ceux-ci au lieu de faire du scraping.

Skills associés