imMamdouhaboammar/x-post

X Post

Toolchain de publicação automatizada e resiliente contra antibot para o X (Twitter), utilizando instâncias reais do Chrome controladas via Chrome DevTools Protocol (CDP).

Requisitos de Execução (Pré-voo)

Antes de executar qualquer script, verifique as dependências do ambiente → references/runtime-setup.md.

Lista de Verificação Essencial:

• Runtime Bun instalado (bun --version)
• Google Chrome ou Chromium instalado (ou X_BROWSER_CHROME_PATH definido)
• Na primeira execução: autentique-se no X na janela do Chrome aberta (sessão salva em ~/.local/share/x-browser-profile)
• Para tradução de vídeos: yt-dlp, ffmpeg e whisper-cli instalados

Se qualquer ferramenta necessária estiver faltando, pare e informe o usuário imediatamente.

---

Capacidades e Mapa de Navegação

Escolha o fluxo de trabalho adequado para a tarefa de publicação:

Tipo de Conteúdo	Caminho do Script	Detalhes e Referência
Texto e Imagens	scripts/x-browser.ts	Posts com uma ou múltiplas imagens e cadeias de threads → references/regular-posts.md
Posts de Vídeo	scripts/x-video.ts	Upload de vídeos com monitoramento de transcodificação → references/video-posts.md
Quote Tweets	scripts/x-quote.ts	Citar tweets existentes com comentário → references/quote-tweets.md
Artigos Longos	scripts/x-article.ts	Artigos Markdown com imagens inline → references/articles.md
Tradução de Vídeo	scripts/x-translate-video.ts	Extração de legendas, tradução e queima → references/video-translation.md
Distribuição Universal	bin/x-post.js	Claude, Marketplace, npx, Skills.sh e todos os agentes → references/distribution.md
Solução de Problemas	N/A	Soluções para erros comuns → references/troubleshooting.md

---

1. Posts Regulares (Texto, Imagens e Threads)

Publique tweets padrão com até 4 imagens e respostas em thread.

# Modo de pré-visualização (verifica a caixa de composição e mantém a janela aberta por 30s)
bun scripts/x-browser.ts "Explorando automação agentiva com Antigravity!" --image ./screenshot.png

# Publicar com imagens e resposta em thread
bun scripts/x-browser.ts "Anunciando nosso novo lançamento open-source!" \
  --image ./banner.png \
  --reply "Confira o repositório aqui: https://github.com/org/repo" \
  --submit

• Detalhes, especificações de imagem e encadeamento de múltiplas threads → references/regular-posts.md

---

2. Posts de Vídeo

Publique vídeos (MP4, MOV, WebM) com upload automático e monitoramento de transcodificação.

# Pré-visualizar upload de vídeo
bun scripts/x-video.ts --video ./demo.mp4 "Assista à demonstração completa da arquitetura"

# Publicar vídeo com citação da fonte em resposta em thread
bun scripts/x-video.ts --video ./demo.mp4 \
  "Benchmark de loop de codificação autônomo" \
  --reply "Benchmark feito no dataset verificado SWE-bench." \
  --submit

• Limites de duração, formatos e estados de upload → references/video-posts.md

---

3. Quote Tweets

Cite um tweet público existente com comentário personalizado, preservando a atribuição da fonte.

# Pré-visualizar quote tweet
bun scripts/x-quote.ts https://x.com/username/status/1234567890 "Perspectiva importante sobre agentes LLM!"

# Publicar quote tweet diretamente
bun scripts/x-quote.ts https://x.com/username/status/1234567890 "Concordo fortemente com esta análise." --submit

• Normalização de URL e seletores de menu → references/quote-tweets.md

---

4. Artigos Longos no X (Markdown)

Converta documentos Markdown com cabeçalhos, listas, blockquotes, imagens de capa e imagens inline em Artigos do X (requer X Premium).

# Pré-visualizar rascunho do artigo formatado
bun scripts/x-article.ts ./article.md --cover ./cover.png

# Publicar artigo diretamente
bun scripts/x-article.ts ./article.md --submit

• Sintaxe de frontmatter e mecânica de placeholders de imagem → references/articles.md

---

5. Tradução de Vídeo e Fluxo de Legendas

Baixe tweets de vídeo em idioma estrangeiro, transcreva o áudio via Whisper, gere arquivos de tradução editáveis, queime legendas estilizadas e publique com atribuição da fonte.

# Passo 1: Ingerir URL e criar rascunho de tradução (/tmp/x-translate/<id>/translation.md)
bun scripts/x-translate-video.ts https://x.com/username/status/1234567890 --target-lang Portuguese

# Passo 2: Editar /tmp/x-translate/<id>/translation.md com cópia traduzida e SRT

# Passo 3: Queimar legendas e pré-visualizar
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md

# Passo 4: Queimar legendas e publicar
bun scripts/x-translate-video.ts --confirm /tmp/x-translate/<id>/translation.md --submit

• Pipeline completo e estilo de legendas com FFmpeg → references/video-translation.md

---

Princípios de Execução e Segurança

1. Sempre Pré-visualize Primeiro: Execute comandos sem --submit durante o desenvolvimento ou revisão manual.
2. Perfil Persistente: Todos os scripts compartilham ~/.local/share/x-browser-profile, portanto a autenticação é necessária apenas uma vez.
3. Digitação Nativa via Teclado: Ativos de mídia usam simulação de colagem em nível de hardware (copy-to-clipboard.ts + paste-from-clipboard.ts) para evitar bloqueios de eventos sintéticos do CDP.
4. Resolução de Problemas: Para timeouts de login, permissões de área de transferência ou erros de conexão CDP → references/troubleshooting.md.