imMamdouhaboammar/x-post

X Post

Automatisierte, Anti-Bot-resistente Publishing-Toolchain für X (Twitter), die echte Chrome-Instanzen über das Chrome DevTools Protocol (CDP) steuert.

Runtime-Anforderungen (Vorabprüfung)

Vor der Ausführung eines Skripts müssen die Umgebungsabhängigkeiten überprüft werden → references/runtime-setup.md.

Wesentliche Checkliste:

• Bun-Laufzeit installiert (bun --version)
• Google Chrome oder Chromium installiert (oder X_BROWSER_CHROME_PATH gesetzt)
• Beim ersten Start: In das geöffnete Chrome-Fenster bei X anmelden (Sitzung wird unter ~/.local/share/x-browser-profile gespeichert)
• Für Videotranslation: yt-dlp, ffmpeg und whisper-cli installiert

Wenn ein erforderliches Tool fehlt, anhalten und den Benutzer sofort informieren.

---

Fähigkeiten & Navigationskarte

Wählen Sie den für die Veröffentlichungsaufgabe geeigneten Workflow aus:

Inhaltstyp	Skript-Pfad	Details & Referenz
Text & Bilder	scripts/x-browser.ts	Einzel-/Mehrbildbeiträge und Thread-Ketten → references/regular-posts.md
Videobeiträge	scripts/x-video.ts	Video-Uploads mit Transkodierungsüberwachung → references/video-posts.md
Zitat-Tweets	scripts/x-quote.ts	Vorhandene Tweets mit Kommentar zitieren → references/quote-tweets.md
Langform-Artikel	scripts/x-article.ts	Markdown-Artikel mit eingebetteten Bildern → references/articles.md
Videotranslation	scripts/x-translate-video.ts	Untertitelextraktion, Übersetzung und Brennung → references/video-translation.md
Universelle Verteilung	bin/x-post.js	Claude, Marketplace, npx, Skills.sh & alle Agenten → references/distribution.md
Fehlerbehebung	N/V	Lösungen für häufige Fehler → references/troubleshooting.md

---

1. Normale Beiträge (Text, Bilder & Threads)

Veröffentlichen Sie Standard-Tweets mit bis zu 4 Bildern und Thread-Antworten.

# Vorschaumodus (prüft das Verfassen-Fenster und hält es 30s offen)
bun scripts/x-browser.ts "Erkunde agentische Automatisierung mit Antigravity!" --image ./screenshot.png

# Veröffentlichen mit Bildern und Thread-Antwort
bun scripts/x-browser.ts "Wir kündigen unser neues Open-Source-Release an!" \
  --image ./banner.png \
  --reply "Schau dir das Repo hier an: https://github.com/org/repo" \
  --submit

• Details, Bildspezifikationen und Multi-Thread-Verkettung → references/regular-posts.md

---

2. Videobeiträge

Veröffentlichen Sie Videos (MP4, MOV, WebM) mit automatischem Upload und Transkodierungs-Polling.

# Vorschau des Video-Uploads
bun scripts/x-video.ts --video ./demo.mp4 "Sieh dir den vollständigen Architektur-Walkthrough an"

# Video mit Quellenangabe in einer Antwort veröffentlichen
bun scripts/x-video.ts --video ./demo.mp4 \
  "Autonomer Coding-Loop-Benchmark" \
  --reply "Benchmark auf dem SWE-bench-verifizierten Datensatz durchgeführt." \
  --submit

• Dauerlimits, Formate und Upload-Status → references/video-posts.md

---

3. Zitat-Tweets

Zitieren Sie einen vorhandenen öffentlichen Tweet mit eigenem Kommentar unter Beibehaltung der Quellenangabe.

# Vorschau des Zitat-Tweets
bun scripts/x-quote.ts https://x.com/benutzer/status/1234567890 "Wichtige Perspektive zu LLM-Agenten!"

# Zitat-Tweet direkt veröffentlichen
bun scripts/x-quote.ts https://x.com/benutzer/status/1234567890 "Stimme dieser Analyse voll und ganz zu." --submit

• URL-Normalisierung und Menü-Selektoren → references/quote-tweets.md

---

4. Langform-X-Artikel (Markdown)

Konvertieren Sie Markdown-Dokumente mit Überschriften, Listen, Blockzitaten, Titelbildern und eingebetteten Bildern in X-Artikel (erfordert X Premium).

# Vorschau des formatierten Artikelentwurfs
bun scripts/x-article.ts ./artikel.md --cover ./cover.png

# Artikel direkt veröffentlichen
bun scripts/x-article.ts ./artikel.md --submit

• Frontmatter-Syntax und Bildplatzhalter-Mechanik → references/articles.md

---

5. Videotranslation & Untertitel-Workflow

Laden Sie fremdsprachige Video-Tweets herunter, transkribieren Sie Audio über Whisper, generieren Sie bearbeitbare Übersetzungsdateien, brennen Sie gestaltete Untertitel ein und veröffentlichen Sie mit Quellenangabe.

# Schritt 1: URL aufnehmen und Übersetzungsentwurf erstellen (/tmp/x-translate/<id>/translation.md)
bun scripts/x-translate-video.ts https://x.com/benutzer/status/1234567890 --target-lang Deutsch

# Schritt 2: /tmp/x-translate/<id>/translation.md mit übersetztem Text und SRT bearbeiten

# Schritt 3: Untertitel brennen und Vorschau anzeigen
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md

# Schritt 4: Untertitel brennen und veröffentlichen
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md --submit

• Vollständige Pipeline und FFmpeg-Untertitelgestaltung → references/video-translation.md

---

Ausführungsprinzipien & Sicherheit

1. Immer zuerst eine Vorschau anzeigen: Befehle während der Entwicklung oder manuellen Überprüfung ohne --submit ausführen.
2. Persistentes Profil: Alle Skripte teilen sich ~/.local/share/x-browser-profile, sodass eine Authentifizierung nur einmal erforderlich ist.
3. Native Tastendruck-Auslösung: Medien-Assets verwenden hardwarenahe Einfüge-Simulationen der Zwischenablage (copy-to-clipboard.ts + paste-from-clipboard.ts), um synthetische CDP-Ereignisblockaden zu vermeiden.
4. Problembehebung: Bei Anmeldezeitüberschreitungen, Berechtigungsproblemen mit der Zwischenablage oder CDP-Verbindungsfehlern → references/troubleshooting.md.