Communitygithub.com

Gamma-Software/post-to-x-skill

Publica um tweet ou thread no X/Twitter através da interface web real (Playwright, sem API paga) — uma skill para Claude Code / agentes.

O que é post-to-x-skill?

Esta skill permite publicar tweets ou threads no X/Twitter utilizando um navegador real controlado via Playwright, sem depender da API oficial do X, que se tornou paga em fevereiro de 2026 (US$ 0,015 por postagem, US$ 0,20 com link). O objetivo é viabilizar autopublicações de baixo volume e ritmo humano, como threads de lançamento ou atualizações de projetos, evitando o uso como bot. A skill exige login manual único (com sessão persistente em ~/.config/post-to-x/x-profile), possui etapas de dry-run (visualização no navegador sem enviar) e validação de conteúdo (limite de 280 caracteres, detecção automática de separadores de tweets, suporte a imagens). Ela funciona com Google Chrome e Playwright, e é indicada para uso em skills de Claude Code, Cursor, Codex e outras ferramentas de agente de IA que queiram publicar no X de forma automatizada, mas controlada e ética.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

post-to-x-skill preview

Documentação

Post to X

Publica um tweet ou thread no X/Twitter utilizando x.com em um navegador real, não a API. A API gratuita do X foi removida em fevereiro de 2026 (pagamento por uso: US$ 0,015/postagem, US$ 0,20 com um link), então esta skill reutiliza uma sessão de navegador na qual você faz login uma vez manualmente e publica através do próprio site. Ela usa o binário real do Chrome + remove as flags de automação para contornar a verificação de "navegador não confiável" do X.

Login único (manual) → analisar texto/thread → compor em dry-run com janela → [usuário OK] → publicar de verdade

Termos de serviço + risco. A postagem automatizada viola os Termos de Serviço do X e pode levar à sinalização da conta. Esta skill é destinada a autopublicações de baixo volume e ritmo humano — uma thread de lançamento, uma atualização de projeto — e não a um robô de envio em massa. Sempre execute o dry-run primeiro, mantenha atrasos humanos e nunca publique em nome do usuário sem uma autorização explícita.

0. Configuração única

O script precisa do Playwright e do Google Chrome instalados (o Chrome é o binário confiável; o Playwright fornece apenas o driver — sem download de navegador).

cd <dir-da-skill> && npm install          # instala o playwright dentro da skill

Em seguida, autentique-se uma vez — abre o Chrome real; o usuário faz o login manualmente (senha + 2FA), a sessão persiste em ~/.config/post-to-x/x-profile:

node scripts/post-x.mjs login

Se channel: "chrome" apresentar erro, o Chrome não foi encontrado — instale o Google Chrome (não apenas o Chromium). A janela de login aguarda até 5 minutos por um estado de login.

1. Prepare o conteúdo

Aceita texto inline ou um arquivo:

  • Tweet único — --text "...".
  • Arquivo de thread — --file <caminho>. Os limites dos tweets são detectados automaticamente:
    1. Marcadores **N/M** por tweet (estilo x-thread.md de build-in-public), caso contrário
    2. tweets separados por uma linha contendo apenas ---, caso contrário
    3. sem separadores → o arquivo inteiro é um tweet.
  • Imagens — por tweet, adicione uma linha _image: caminho_ ou ![](caminho) dentro daquele tweet; ou anexe ao primeiro tweet com --image <caminho> repetível. O X aceita até 4 imagens por tweet. Os caminhos são relativos ao arquivo.
  • Removidos automaticamente: citações > ... (banners DRAFT), cabeçalhos # ..., notas _(...chars...)_.

Mantenha cada tweet com ≤ 280 caracteres — o script exibe a contagem e sinaliza os que excederem.

2. Dry-run (passo obrigatório)

Sempre componha visivelmente sem enviar primeiro, para que o usuário veja a thread real no compositor do X:

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

Ele digita cada tweet no modal de composição (adicionando posts de thread através do botão "+"), anexa imagens, depois aguarda 30 segundos e fecha — nada é publicado. Mostre ao usuário; obtenha uma autorização explícita.

3. Publique de verdade

Somente após a aprovação do usuário, remova --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 mostra o navegador; o padrão é headless. O script clica em "Post all" (thread) / "Post" (único) do X e confirma que o compositor fechou.

4. Validação

  • Validação de análise — --parse-only exibe os tweets analisados + contagem de caracteres + caminhos de imagem e sai. Execute-o sempre que o formato do arquivo não for óbvio.
  • Validação de dry-run — a composição com janela acima é a prova real de que a publicação será correta; pular essa etapa já resultou no envio de uma thread quebrada (seletores ambíguos, divisão errada de tweets).
  • Validação de sessão — se o compositor nunca carregar, a sessão expirou → execute login novamente.

5. Relatório

Informe ao usuário: quantos tweets foram publicados (ou compostos, em dry-run), se algum tweet ultrapassou 280 caracteres, imagens anexadas e o diretório de perfil utilizado. Se um seletor falhar, informe em qual etapa e que a interface do X provavelmente mudou (os data-testid no post-x.mjs são a parte frágil).

Notas

  • Seletores usados: tweetTextarea_<i>, addButton, fileInput, tweetButton — escopados ao [role="dialog"] do compositor. Atualize estes em scripts/post-x.mjs se o X reformular o compositor.
  • A sessão fica em ~/.config/post-to-x/x-profile (substitua com --profile). Fica fora do repositório — nunca a versionne.
  • Apenas X; LinkedIn/Mastodon/Bluesky têm APIs gratuitas — use um agendador (Postiz, Buffer, Typefully) para essas plataformas em vez de scraping.

Habilidades Relacionadas