SuperX 是用于 Twitter/X 账号增长的 CLI 工具,通过 SuperX API 提供帖子、数据分析、联系人、联系人列表、受众回复、信号代理及其线索、灵感、标签、排期(支持图片)、长文 Articles 以及 Context(AI 写作背景)设置等能力。
使用前需先运行 superx status 检查认证;若未安装二进制文件,执行 npm install -g superx-cli 安装。未认证时可运行 superx login(交互式)或设置 export SUPERX_API_KEY=sxk_...(CI 与非交互会话)。密钥在 https://app.superx.so/account?tab=api 创建。
核心工作流:superx status 验证密钥;superx accounts 发现账号;用 posts:list、posts:analytics、contacts:list 读取数据;参考 growth-strategy.md 后创建内容;用 scheduled:create 先建草稿再排期;用 scheduled:list 验证。
写入约束:scheduled:create 不加 --at 创建草稿(不会发布),加 --at 才排期。时间戳必须为带 Z 或偏移量的 UTC ISO-8601。posts:publish 与 articles:publish 会立即且不可逆地发布到 X,需人工确认文本。图片需先 media:upload 再通过 --media 附加,不支持视频。共享给他人的账号为只读。
输出为干净 JSON,人类/状态信息输出到 stderr,成功退出码 0,错误退出码 1。速率限制按账号所有者计算,429 时按提示退避重试。
限制与注意事项:草稿没有排期时间;--at 需至少 60 秒后且在 18 个月内;只读密钥无法写入;图片最大 4 张或 1 个 GIF;线程最多 25 部分、总计 25,000 字符;articles:publish 需要 X Premium;系统列表只读。