Twitter Post 是一个基于官方 Twitter/X API v2 的命令行工具，专为通过 OAuth 1.0a 认证在 X 平台（原 Twitter）上发布内容而设计。该工具支持多种推文操作模式，包括单条推文、回复、引用推文以及连续推文串（线程），适用于自动化脚本、定时发布或手动快速发推等场景。用户只需配置四个核心环境变量——API Key、API Key Secret、Access Token 和 Access Token Secret，即可安全调用 X 的接口，无需硬编码密钥，保障账户安全。
该工具采用 Node.js 编写，脚本路径为 `scripts/tweet.js`，所有操作均通过 `exec` 命令执行。它内置字符长度校验机制，自动识别 CJK 字符（中日韩文字）按双倍权重计算，并确保 URL 统一计为 23 个字符，防止因超限导致发布失败。此外，工具支持试运行模式（`TWITTER_DRY_RUN=1`），可在不实际发帖的情况下验证内容合规性，极大提升开发调试效率。对于需要代理访问的地区，还可通过 `HTTPS_PROXY` 环境变量设置 HTTP 代理。
输出结果以 JSON 格式返回，包含成功状态、推文 ID、X 链接及剩余配额信息；出错时则返回错误详情，便于集成到自动化流程中进行日志记录与异常处理。整体设计兼顾安全性、灵活性与易用性，是开发者、内容运营者或自动化系统接入 X 平台的轻量级解决方案。
核心功能特点
- 支持单条推文、回复、引用推文和推文线程（Thread）四种发布模式
- 内置智能字符计数，CJK 字符按双倍权重、URL 统一计为 23 字符，自动拦截超限内容
- 使用 OAuth 1.0a 认证，通过环境变量管理密钥，避免代码泄露风险
- 提供试运行模式（dry run），可预览推文效果而不实际发布
- JSON 结构化输出，包含推文 ID、链接及 API 配额余量，便于程序化处理
- 兼容代理环境，支持 HTTPS_PROXY 配置，适应不同网络条件
适用场景
Twitter Post 特别适合需要高频或定时在 X 平台发布内容的场景，例如社交媒体运营团队用于每日推送产品更新、活动公告或行业资讯。通过将其集成到 CI/CD 流水线中，可在构建成功后自动发送部署通知；也可结合 Notion 或数据库内容抓取脚本，实现从知识库自动生成并发布推文。对于个人用户而言，该工具简化了 OAuth 流程，使非技术背景的内容创作者也能轻松实现自动化发推。
在开发测试环境中，利用 `–dry-run` 功能可快速验证推文格式是否符合平台规范，减少因字符超限或格式错误导致的发布失败。对于多账号管理需求，可通过分别配置不同的环境变量实现轮询发布或负载均衡。此外，结合 cron 任务可实现无人值守的定时推文调度，如每日早安问候、节日祝福或数据报告摘要，显著提升内容触达效率。
当需要围绕某条热门推文展开讨论时，该工具支持引用式回复（quote tweet），既能保留原始上下文，又能添加评论观点，增强互动性。而对于系列化内容，如教程拆解、事件回顾或多图长文，使用线程模式可自动串联多条推文，保持阅读连贯性，避免用户被分散到多个独立帖子中。总之，无论是个人创作、团队协作还是系统集成，Twitter Post 都提供了稳定可靠的底层能力支撑。