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:- Marcadores
**N/M**por tweet (estilox-thread.mdde build-in-public), caso contrário - tweets separados por uma linha contendo apenas
---, caso contrário - sem separadores → o arquivo inteiro é um tweet.
- Marcadores
- Imagens — por tweet, adicione uma linha
_image: caminho_oudentro 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-onlyexibe 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
loginnovamente.
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 emscripts/post-x.mjsse 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.