imMamdouhaboammar/x-post

X Post

Cadena de herramientas de publicación automatizada y resistente a bots para X (Twitter) que aprovecha instancias reales de Chrome controladas a través del Protocolo de DevTools de Chrome (CDP).

Requisitos de ejecución (Pre-vuelo)

Antes de ejecutar cualquier script, verifique las dependencias del entorno → references/runtime-setup.md.

Lista de verificación esencial:

• Runtime Bun instalado (bun --version)
• Google Chrome o Chromium instalado (o establecer X_BROWSER_CHROME_PATH)
• Primera ejecución: autentíquese en X en la ventana de Chrome abierta (la sesión se guarda en ~/.local/share/x-browser-profile)
• Para traducción de videos: yt-dlp, ffmpeg y whisper-cli instalados

Si falta alguna herramienta requerida, deténgase e informe al usuario inmediatamente.

---

Capacidades y mapa de navegación

Elija el flujo de trabajo adecuado para la tarea de publicación:

Tipo de contenido	Ruta del script	Detalles y referencia
Texto e imágenes	scripts/x-browser.ts	Posts de una o varias imágenes y cadenas de hilos → references/regular-posts.md
Posts de video	scripts/x-video.ts	Cargas de video con monitoreo de transcodificación → references/video-posts.md
Quote Tweets	scripts/x-quote.ts	Citar tweets existentes con comentarios → references/quote-tweets.md
Artículos largos	scripts/x-article.ts	Artículos en Markdown con imágenes incrustadas → references/articles.md
Traducción de video	scripts/x-translate-video.ts	Extracción, traducción y quema de subtítulos → references/video-translation.md
Distribución universal	bin/x-post.js	Claude, Marketplace, npx, Skills.sh y todos los agentes → references/distribution.md
Solución de problemas	N/A	Soluciones para errores comunes → references/troubleshooting.md

---

1. Posts regulares (Texto, imágenes e hilos)

Publique tweets estándar con hasta 4 imágenes y respuestas en hilo.

# Modo de previsualización (verifica el cuadro de redacción y mantiene la ventana abierta durante 30 s)
bun scripts/x-browser.ts "Explorando la automatización agente con Antigravity!" --image ./screenshot.png

# Publicar con imágenes y respuesta en hilo
bun scripts/x-browser.ts "¡Anunciando nuestro nuevo lanzamiento de código abierto!" \
  --image ./banner.png \
  --reply "Mira el repositorio aquí: https://github.com/org/repo" \
  --submit

• Detalles, especificaciones de imagen y encadenamiento de hilos múltiples → references/regular-posts.md

---

2. Posts de video

Publique videos (MP4, MOV, WebM) con carga automática y sondeo de transcodificación.

# Previsualizar carga de video
bun scripts/x-video.ts --video ./demo.mp4 "Vea el recorrido completo de la arquitectura"

# Publicar video con cita de fuente en hilo de respuesta
bun scripts/x-video.ts --video ./demo.mp4 \
  "Benchmark del bucle de codificación autónomo" \
  --reply "Evaluado en el conjunto de datos verificado de SWE-bench." \
  --submit

• Límites de duración, formatos y estados de carga → references/video-posts.md

---

3. Quote Tweets

Cite un tweet público existente con comentarios personalizados mientras conserva la atribución de la fuente.

# Previsualizar quote tweet
bun scripts/x-quote.ts https://x.com/username/status/1234567890 "¡Perspectiva importante sobre los agentes LLM!"

# Publicar quote tweet directamente
bun scripts/x-quote.ts https://x.com/username/status/1234567890 "Estoy muy de acuerdo con este análisis." --submit

• Normalización de URL y selectores de menú → references/quote-tweets.md

---

4. Artículos largos en X (Markdown)

Convierta documentos Markdown con encabezados, listas, citas en bloque, imágenes de portada e imágenes incrustadas en artículos de X (requiere X Premium).

# Previsualizar borrador de artículo formateado
bun scripts/x-article.ts ./article.md --cover ./cover.png

# Publicar artículo directamente
bun scripts/x-article.ts ./article.md --submit

• Sintaxis de frontmatter y mecánica de marcadores de posición de imagen → references/articles.md

---

5. Traducción de video y flujo de trabajo de subtítulos

Descargue tweets de video en idioma extranjero, transcriba audio a través de Whisper, genere archivos de traducción editables, queme subtítulos con estilo y publique con atribución de fuente.

# Paso 1: Incorporar URL y crear borrador de traducción (/tmp/x-translate/<id>/translation.md)
bun scripts/x-translate-video.ts https://x.com/username/status/1234567890 --target-lang English

# Paso 2: Editar /tmp/x-translate/<id>/translation.md con la copia traducida y SRT

# Paso 3: Quemar subtítulos y previsualizar
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md

# Paso 4: Quemar subtítulos y publicar
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md --submit

• Canalización completa y estilo de subtítulos con FFmpeg → references/video-translation.md

---

Principios de ejecución y seguridad

1. Siempre previsualice primero: Ejecute los comandos sin --submit durante el desarrollo o la revisión manual.
2. Perfil persistente: Todos los scripts comparten ~/.local/share/x-browser-profile, por lo que la autenticación solo es necesaria una vez.
3. Envío de pulsaciones nativas: Los activos multimedia utilizan simulación de pegado a nivel de hardware (copy-to-clipboard.ts + paste-from-clipboard.ts) para evitar los bloqueos de eventos sintéticos de CDP.
4. Resolución de problemas: Para tiempos de espera de inicio de sesión, permisos de portapapeles o errores de conexión CDP → references/troubleshooting.md.