Communitygithub.com

Beitrag auf X veröffentlichen

Veröffentlicht einen Tweet oder Thread über die echte X-Web-Oberfläche (Playwright, keine kostenpflichtige API) — ein Skill für Claude Code / Agenten.

Was ist Beitrag auf X veröffentlichen?

Dieser Skill ermöglicht es KI-Agenten, Tweets oder Threads direkt auf X (ehemals Twitter) zu veröffentlichen, indem er die reale Web-Oberfläche über einen Browser-Automation-Treiber steuert – ganz ohne die kostenpflichtige API von X, die seit Februar 2026 gebührenpflichtig ist. Das Tool ist auf niedrigvolumige, manuell bestätigte Veröffentlichungen ausgelegt (z. B. Release-Threads oder Updates) und bietet mehrere Sicherheitsstufen: einen manuellen Login-Schritt für die Browsersession, eine zwingende Vorschau im sichtbaren Browser (Dry-Run), sowie eine explizite Benutzerbestätigung vor der tatsächlichen Veröffentlichung. Es unterstützt sowohl einzelne Tweets als auch Threads mit automatischer Aufteilung, Anhängen von Bildern und elektronischer Längenprüfung. Besonders hervorzuheben ist der Hinweis, dass der Skill nicht für Bots oder Massenpostings gedacht ist – er respektiert die Nutzungsbedingungen von X und minimiert Risiken durch menschliche Kontrollschritte. Der Skill wird unter anderem mit Claude Code, Cursor und ähnlichen Entwicklerwerkzeugen genutzt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

Beitrag auf X veröffentlichen preview

Dokumentation

Was macht Beitrag auf X veröffentlichen?

Veröffentlicht einen Tweet oder Thread auf X/Twitter, indem x.com in einem echten Browser gesteuert wird – nicht über die API. X hat die kostenlose API im Februar 2026 abgeschafft (Nutzungsgebühr: 0,015 $/Post, 0,20 $ mit Link). Daher wird hier eine Browser-Session wiederverwendet, in die du einmalig von Hand eingeloggt hast, und die Beiträge werden direkt über die Seite veröffentlicht. Es wird die echte Chrome-Binärdatei verwendet + die Automatisierungsflags werden entfernt, um X' Prüfung auf „Browser nicht vertrauenswürdig“ zu umgehen.

Einmaliger Login (manuell) → Text/Thread parsen → im sichtbaren Browser verfassen (Dry-Run) → [Benutzer OK] → für echt veröffentlichen

Nutzungsbedingungen + Risiko. Automatisierte Beiträge verstoßen gegen die Nutzungsbedingungen von X und können zur Kennzeichnung des Kontos führen. Dies ist für niedrigvolumige, menschengetaktete Selbstveröffentlichungen gedacht – ein Release-Thread, ein „Build in Public“-Update – nicht für einen Massen-Bot. Führe immer zuerst einen Dry-Run durch, halte die Verzögerungen menschlich und veröffentliche niemals im Namen des Benutzers ohne explizite Zustimmung.

0. Einmalige Einrichtung

Das Skript benötigt Playwright und Google Chrome (Chrome ist die vertrauenswürdige Binärdatei; Playwright liefert nur den Treiber – kein Browser-Download).

cd <skill-verzeichnis> && npm install          # installiert playwright in den Skill

Anschließend einmalige Authentifizierung – öffnet echten Chrome; der Benutzer meldet sich von Hand an (Passwort + 2FA), die Session bleibt in ~/.config/post-to-x/x-profile erhalten:

node scripts/post-x.mjs login

Wenn channel: "chrome" einen Fehler meldet, ist Chrome nicht gefunden – installiere Google Chrome (nicht nur Chromium). Das Login-Fenster wartet bis zu 5 Minuten auf einen eingeloggten Zustand.

1. Inhalt vorbereiten

Akzeptiert entweder Inline-Text oder eine Datei:

  • Einzelner Tweet – --text "…".
  • Thread-Datei – --file <pfad>. Tweet-Grenzen werden automatisch erkannt:
    1. **N/M**-Markierungen pro Tweet (Build-in-Public x-thread.md-Stil), sonst
    2. Tweets getrennt durch eine Zeile, die nur --- enthält, sonst
    3. Keine Trennzeichen → die gesamte Datei ist ein Tweet.
  • Bilder – pro Tweet eine Zeile _image: pfad_ oder ![](pfad) innerhalb dieses Tweets; oder an den ersten Tweet anhängen mit wiederholbarem --image <pfad>. X erlaubt bis zu 4 pro Tweet. Pfade sind relativ zur Datei.
  • Automatisch entfernt: > …-Blockzitate (DRAFT-Banner), # …-Überschriften, _(…Zeichen…)_-Notizen.

Halte jeden Tweet ≤ 280 Zeichen – das Skript gibt die Zeichenzahl aus und markiert Überschreitungen.

2. Dry-Run (zwingende Kontrollstufe)

Immer zuerst ohne Absenden sichtbar verfassen, damit der Benutzer den echten Thread im X-Editor sieht:

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

Es tippt jeden Tweet in das Verfassen-Modal ein (fügt Thread-Beiträge über den „+“-Button hinzu), hängt Bilder an, hält dann 30 s an und schließt – es wird nichts veröffentlicht. Zeige dem Benutzer das Ergebnis; hole ein explizites OK ein.

3. Für echt veröffentlichen

Erst nach Zustimmung des Benutzers --dry-run entfernen:

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

--headed zeigt den Browser an; Standard ist headless. Das Skript klickt auf X' „Alle posten“ (Thread) / „Posten“ (einzeln) und bestätigt, dass der Editor geschlossen wurde.

4. Validierung

  • Parse-Kontrolle – --parse-only gibt die geparsten Tweets + Zeichenanzahl + Bildpfade aus und beendet sich. Verwende es, wenn das Dateiformat unklar ist.
  • Dry-Run-Kontrolle – die sichtbare Vorschau oben ist der echte Nachweis, dass es korrekt veröffentlichen wird; das Überspringen hatte schon einen fehlerhaften Thread zur Folge (mehrdeutige Selektoren, falsche Tweet-Aufteilung).
  • Session-Kontrolle – wenn der Editor nie lädt, ist die Session abgelaufen → login erneut ausführen.

5. Bericht

Teile dem Benutzer mit: wie viele Tweets veröffentlicht (oder bei einem Dry-Run verfasst) wurden, ob ein Tweet über 280 Zeichen lag, welche Bilder angehängt wurden und welches Profilverzeichnis verwendet wurde. Falls ein Selektor fehlschlug, gib an, bei welchem Schritt und dass sich die UI von X wahrscheinlich geändert hat (die data-testids in post-x.mjs sind der zerbrechliche Teil).

Hinweise

  • Verwendete Selektoren: tweetTextarea_<i>, addButton, fileInput, tweetButton – begrenzt auf den Compose-Dialog [role="dialog"]. Aktualisiere diese in scripts/post-x.mjs, falls X den Editor umbaut.
  • Die Session liegt in ~/.config/post-to-x/x-profile (überschreibbar mit --profile). Sie befindet sich außerhalb des Repositorys – niemals einchecken.
  • Nur X; LinkedIn/Mastodon/Bluesky haben kostenlose APIs – verwende für diese eine Planungssoftware (Postiz, Buffer, Typefully) anstatt zu scrapen.

Verwandte Skills