twitter-cli 是一个专为开发者设计的命令行工具,用于通过终端直接与 Twitter/X 平台交互。它支持完整的推文读写操作,包括读取主页动态、发布新推文、回复、引用转发、点赞、收藏、关注用户等核心功能。该工具采用 Python 编写,兼容 Python 3.8+ 环境,可通过 uv 或 pipx 快速安装。其最大特点是无需依赖官方 API,而是通过自动提取浏览器登录状态下的 Cookie 实现身份验证,从而绕过常见的自动化检测限制。这使得即使在频繁执行写操作(如发帖、回复)时,也能有效避免触发 X 平台的‘疑似机器人行为’错误(HTTP 226)。工具默认输出美观的富文本表格,同时也支持 YAML、JSON 和紧凑模式等多种结构化格式,方便集成到脚本或 LLM 工作流中。
核心功能特点
- 支持完整的 Twitter/X 操作:读推文、发推、回复、引用、点赞、转发、关注、搜索及查询用户信息
- 通过浏览器 Cookie 自动认证,避免 API 限制和 226 错误,尤其适合高频写操作场景
- 多格式输出支持:默认富表、YAML、JSON 和紧凑模式(-c),适配不同使用需求
- 内置防检测机制:随机延迟、TLS 指纹匹配,降低被识别为机器人的风险
- 支持线程化操作:可批量处理搜索结果、点赞、关注等任务,提升效率
适用场景
twitter-cli 特别适合需要自动化处理 Twitter/X 内容的开发者和内容运营人员。例如,在构建 AI 代理系统时,它可以作为自然语言接口,让模型通过命令行调用获取最新推文、监控关键词话题或分析用户互动数据。对于研究人员而言,该工具可用于批量下载特定用户的推文或热门话题讨论,并以 JSON 格式导出供后续 NLP 分析。在日常工作中,内容创作者可以利用它快速发布推文、回复粉丝评论,甚至构建自动化线程(thread)发布流程。此外,由于支持紧凑输出模式(-c),它非常适合嵌入到基于 LLM 的对话系统中,以最小化 token 消耗同时保持关键信息完整。需要注意的是,虽然功能强大,但当前版本暂不支持私信、媒体上传、投票创建及通知读取等功能。
