convez.ai
SkillAutomaçãoIntermediário
piao0123

X Post Project - Automação de Postagens

piao0123/x-post-project

Automação de postagens no X com agendamento e verificação de caracteres

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta de automação para criar e publicar posts no X (Twitter) com suporte a agendamento. Funciona em macOS (AppleScript) e Linux (Playwright), incluindo utilitários para verificação de caracteres e captura de conteúdo via Exa.

Instalação

$npx convez-ai piao0123/x-post-project

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Publicar posts no X de forma automatizada sem interface manual
  • Agendar postagens para horários específicos
  • Integrar fluxos de conteúdo com verificação automática de limites de caracteres

Veredito

Skill focada e funcional para automação de postagens no X, com implementações específicas por SO (macOS/Linux). Limitações claras sobre API do Twitter e dependências de elementos da UI que podem quebrar com atualizações da plataforma.

README

A tradução para o português deste README ainda está na fila.

X Post Project

X(Twitter)帖子创作发布自动化工具,支持 macOS 和 Linux。

🖥️ 平台支持

操作系统发布脚本依赖
macOSscripts/post-with-schedule-v2.shAppleScript + Chrome
Linuxscripts/post-with-schedule.pyPlaywright + Chromium

📁 目录结构

x-post-project/
├── SKILL.md                          # 主skill说明文档
├── README.md                          # 本文件
├── scripts/
│   ├── post-with-schedule.py          # Linux发布脚本(Playwright)
│   ├── post-with-schedule-v2.sh       # macOS发布脚本(AppleScript)
│   ├── check-char-count.py            # X字数检查工具
│   └── post-with-schedule.sh          # macOS脚本v1(旧版)
├── x-post-workflow/
│   └── SKILL.md                       # 完整工作流skill
├── x-post-scheduler/
│   ├── SKILL.md                       # 定时发布skill
│   └── scripts/                       # 软链接到上方scripts/
│       ├── post-with-schedule.sh -> ../../scripts/post-with-schedule.sh
│       └── post-with-schedule-v2.sh -> ../../scripts/post-with-schedule-v2.sh
└── posts/                             # 帖子内容存放目录

🚀 快速开始

Step 1: 安装依赖(Linux)

pip3 install playwright
playwright install chromium
apt install chromium-browser

Step 2: 内容抓取

使用 Exa 搜索抓取热门帖子(推荐):

# 需要配置 mcporter / Exa API
mcporter call 'exa.web_search_exa(query: "site:twitter.com 关键词 min_faves:1000", numResults: 5)'

Step 3: 字数检查

# 直接检查文本
python3 scripts/check-char-count.py "这是测试内容"

# 检查文件(自动去除markdown格式)
python3 scripts/check-char-count.py posts/category/02-post-humanized.md

Step 4: 发布帖子

Linux(推荐):

# 立即发布
python3 scripts/post-with-schedule.py content.txt

# 定时发布
python3 scripts/post-with-schedule.py content.txt --schedule "2026-06-15 21:00"

# 带图片 + 定时
python3 scripts/post-with-schedule.py content.txt image.jpg --schedule "2026-06-15 21:00"

macOS:

# 立即发布
bash scripts/post-with-schedule-v2.sh content.txt

# 定时发布
bash scripts/post-with-schedule-v2.sh content.txt image.jpg --schedule "2026-06-15 21:00"

🔧 主要修复记录

2026-06-15

  • 新增 Linux 版发布脚本 post-with-schedule.py(基于 Playwright)
  • 修复日期时间前导零 Bug(sed 's/^0//' 导致 X select value 不匹配)
  • 新增 check-char-count.py 字数检查脚本
  • 移除所有硬编码 /Users/piaoxian/ 路径
  • 清理重复脚本,使用软链接统一管理
  • 支持读取 .md 文件并自动提取纯文本

⚠️ 已知限制

  • Twitter API 免费套餐:不支持搜索,只能发推文
  • Linux 剪贴板:需要 xclip(可选,脚本改用键盘直接输入)
  • X 页面结构变化:X 页面更新后可能需要调整选择器
Ver o original no GitHub

Bom para

Relacionados