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 GitHubFerramenta 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-project1 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
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。
🖥️ 平台支持
| 操作系统 | 发布脚本 | 依赖 |
|---|---|---|
| macOS | scripts/post-with-schedule-v2.sh | AppleScript + Chrome |
| Linux | scripts/post-with-schedule.py | Playwright + 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 页面更新后可能需要调整选择器