用途:twitter-cli 是面向终端的 Twitter/X 命令行工具,无需 API Key,使用浏览器 Cookie 认证,适合在终端阅读信息流、搜索、导出数据,以及供 AI 智能体以结构化输出调用。
主要能力:读取方面支持 For You/Following 时间线、书签、搜索、推文详情与回复、文章、列表时间线、用户资料与用户推文、关注者等;写入方面支持发帖、回复、引用、删除、点赞/取消、转推/取消、收藏/取消、关注/取关。认证支持从 Arc/Chrome/Edge/Firefox/Brave 提取 Cookie,或用环境变量 TWITTER_AUTH_TOKEN 与 TWITTER_CT0。输出支持富表格(默认)、JSON、YAML、Markdown(文章),非 TTY 默认 YAML。
使用方式:安装可用 uv tool install twitter-cli 或 pipx install twitter-cli,升级用 uv tool upgrade twitter-cli。认证优先环境变量,其次浏览器 Cookie;可指定 TWITTER_BROWSER=chrome,Chrome 多配置用 TWITTER_CHROME_PROFILE="Profile 2"。代理用 TWITTER_PROXY。常用命令如 twitter feed、twitter search "AI agent"、twitter bookmarks、twitter tweet <id>、twitter article <id> --markdown、twitter user-posts elonmusk --max 20、twitter post "Hello" --image photo.jpg、twitter reply、twitter quote、twitter delete、twitter like、twitter retweet、twitter bookmark、twitter follow。可在工作目录创建 config.yaml 配置抓取数量、过滤模式(topN/score/all)、评分权重与限速参数。
适用场景:终端阅读与导出时间线、书签分析、按互动量排序搜索、监控用户推文、将文章导出为 Markdown、在 Python 或脚本中通过 subprocess 调用 JSON/YAML 输出接入智能体流程。
限制:依赖浏览器 Cookie,Cookie 过期会返回 401/403,需重新登录;macOS 可能遇到钥匙串访问问题;存在速率限制(HTTP 429),建议用 --max 控制请求量、设置代理并增大 requestDelay;建议使用住宅代理而非数据中心 IP,避免频繁运行。部分功能(如用户点赞)自 2024 年 6 月起为私有,仅限本人账号。Windows 下 AI 智能体子进程管道输出可能受 ConPTY 影响,可改用 Git Bash 或关闭 windowsEnableConpty。