步骤 1：引导用户进行认证

方法 A：浏览器 cookie 提取（推荐）

确保用户已登录 x.com，浏览器可以是：Arc、Chrome、Edge、Firefox、Brave 之一。twitter-cli 会自动提取 cookies。所有 Chrome 配置文件都会被自动扫描。要指定配置文件：TWITTER_CHROME_PROFILE="Profile 2" twitter feed。要优先使用特定浏览器：TWITTER_BROWSER=chrome twitter feed（支持的浏览器：arc、chrome、edge、firefox、brave）。

twitter whoami

方法 B：环境变量

export TWITTER_AUTH_TOKEN="<从浏览器获取的 auth_token>"
export TWITTER_CT0="<从浏览器获取的 ct0>"
twitter whoami

方法 C：完整的 cookie 字符串（适用于云端/远程智能体）

告诉用户：

我需要你的 Twitter 登录凭证。请按以下步骤获取：

1. 用 Chrome/Edge/Firefox 打开 https://x.com（确保已登录）
2. 按 F12 打开开发者工具 → Network 标签
3. 在页面上刷新，点击任意 x.com 请求
4. 找到 Request Headers → Cookie: 这一行，右键 → 复制值
5. 把完整 Cookie 字符串发给我

⚠️ Cookie 包含登录信息，请不要分享给其他人。

然后提取并设置环境变量：

FULL_COOKIE="<用户的 cookie 字符串>"
export TWITTER_AUTH_TOKEN=$(echo "$FULL_COOKIE" | grep -oE 'auth_token=[a-f0-9]+' | cut -d= -f2)
export TWITTER_CT0=$(echo "$FULL_COOKIE" | grep -oE 'ct0=[a-f0-9]+' | cut -d= -f2)
twitter whoami

步骤 2：处理常见的认证问题

输出格式

默认：富表格（人类可读）

twitter feed                          # 漂亮的表格输出

YAML / JSON：结构化输出

非 TTY 标准输出默认自动使用 YAML 格式。使用 OUTPUT=yaml|json|rich|auto 来覆盖此设置。

twitter feed --yaml
twitter feed --json | jq '.[0].text'

所有机器可读的输出都使用 SCHEMA.md 中记录的封装格式。推文和用户数据现在位于 .data 下。

完整文本：--full-text 标志（仅限富表格）

当用户希望在终端表格中看到完整的帖子正文时，使用 --full-text。它影响富表格列表视图，例如 feed、bookmarks、search、user-posts、likes、list 以及 tweet 中的回复表格。它不会改变 --json、--yaml 或 -c 紧凑模式的输出。

twitter feed --full-text
twitter search "AI agent" --full-text
twitter user-posts elonmusk --max 20 --full-text
twitter tweet 1234567890 --full-text

紧凑模式：-c 标志（为 LLM 提供最少的标记）

twitter -c feed --max 10              # 最少的字段，非常适合 LLM 上下文
twitter -c search "AI" --max 20       # 比 --json 少约 80% 的标记

紧凑模式字段（每条推文）： id、author (@句柄)、text（截断至 140 字符）、likes、rts、time（短格式）

命令参考

读操作

twitter status                         # 快速认证检查
twitter status --yaml                  # 结构化的认证状态
twitter whoami                         # 当前认证用户
twitter whoami --yaml                  # YAML 输出
twitter whoami --json                  # JSON 输出
twitter user elonmusk                  # 用户资料
twitter user elonmusk --json           # JSON 输出
twitter feed                           # 首页时间线（为你推荐）
twitter feed -t following              # 关注时间线
twitter feed --max 50                  # 限制数量
twitter feed --full-text               # 在表格中显示完整的帖子正文
twitter feed --filter                  # 启用排名过滤器
twitter feed --yaml > tweets.yaml      # 导出为 YAML
twitter feed --input tweets.json       # 从本地 JSON 文件读取
twitter bookmarks                      # 已收藏的推文
twitter bookmarks --full-text          # 收藏夹表格中的完整文本
twitter bookmarks --max 30 --yaml
twitter search "keyword"               # 搜索推文
twitter search "AI agent" -t Latest --max 50
twitter search "AI agent" --full-text  # 搜索结果中的完整文本
twitter search "topic" -o results.json # 保存到文件
twitter tweet 1234567890               # 推文详情 + 回复
twitter tweet 1234567890 --full-text   # 回复表格中的完整文本
twitter tweet https://x.com/user/status/12345  # 接受 URL
twitter show 2                         # 打开上次 feed/search 列表中的第 2 条推文
twitter show 2 --full-text             # 回复表格中的完整文本
twitter show 2 --json                  # 结构化输出
twitter list 1539453138322673664       # 列表时间线
twitter list 1539453138322673664 --full-text
twitter user-posts elonmusk --max 20   # 用户的推文
twitter user-posts elonmusk --full-text
twitter likes elonmusk --max 30        # 用户的点赞（仅限自己的账户，见备注）
twitter likes elonmusk --full-text
twitter followers elonmusk --max 50    # 关注者
twitter following elonmusk --max 50    # 正在关注

写操作

twitter post "Hello from twitter-cli!"              # 发布推文
twitter post "Hello!" --image photo.jpg              # 发布带图片的推文
twitter post "Gallery" -i a.png -i b.jpg             # 最多 4 张图片
twitter reply 1234567890 "Great tweet!"              # 回复（独立命令）
twitter reply 1234567890 "Nice!" -i pic.png          # 带图片的回复
twitter post "reply text" --reply-to 1234567890      # 回复（通过 post 命令）
twitter quote 1234567890 "Interesting take"          # 引用推文
twitter quote 1234567890 "Look" -i chart.png         # 带图片的引用推文
twitter delete 1234567890                            # 删除推文
twitter like 1234567890                              # 点赞
twitter unlike 1234567890                            # 取消点赞
twitter retweet 1234567890                           # 转推
twitter unretweet 1234567890                         # 取消转推
twitter bookmark 1234567890                          # 收藏
twitter unbookmark 1234567890                        # 取消收藏
twitter follow elonmusk                              # 关注用户
twitter unfollow elonmusk                            # 取消关注用户

图片上传注意事项：

• 支持的格式：JPEG、PNG、GIF、WebP
• 最大文件大小：每张图片 5 MB
• 每条推文最多 4 张图片
• 使用 --image / -i（可重复使用）

智能体工作流

发布并验证

twitter post "My tweet text" 2>/dev/null
# 输出包含推文 URL：🔗 https://x.com/i/status/<id>

发布带图片的推文

# 单张图片
twitter post "Check this out!" --image /path/to/photo.jpg

# 多张图片
twitter post "Photo gallery" -i img1.png -i img2.jpg -i img3.webp

回复某人最新的推文

TWEET_ID=$(twitter user-posts targetuser --max 1 --json | jq -r '.data[0].id')
twitter reply "$TWEET_ID" "Nice post!"

创建推文串

# 发布第一条推文，捕获输出以获取推文 ID
twitter post "Thread 1/3: First point"
# 从输出中记下推文 ID，然后：
twitter reply <first_tweet_id> "2/3: Second point"
twitter reply <second_tweet_id> "3/3: Final point"

带评论的引用推文

TWEET_ID=$(twitter search "interesting topic" --max 1 --json | jq -r '.data[0].id')
twitter quote "$TWEET_ID" "This is a great insight!"

点赞所有搜索结果

twitter search "interesting topic" --max 5 --json | jq -r '.data[].id' | while read id; do
  twitter like "$id"
done

获取用户信息然后关注

twitter user targethandle --json | jq '.data | {username, followers, bio}'
twitter follow targethandle

查找用户最受欢迎的推文

twitter user-posts elonmusk --max 20 --json | jq '.data | sort_by(.metrics.likes) | reverse | .[:3] | .[] | {id, text: .text[:80], likes: .metrics.likes}'

检查关注关系

MY_NAME=$(twitter whoami --json | jq -r '.data.user.username')
twitter followers "$MY_NAME" --max 200 --json | jq -r '.data[].username' | grep -q "targetuser" && echo "Yes" || echo "No"

每日阅读工作流

# 紧凑模式，用于节省标记的 LLM 上下文
twitter -c feed -t following --max 30
twitter -c bookmarks --max 20

# 富表格，包含完整的帖子正文
twitter feed -t following --max 20 --full-text
twitter search "AI agent" --max 20 --full-text

# 用于分析的完整 JSON
twitter feed -t following --max 30 -o following.json
twitter bookmarks --max 20 -o bookmarks.json

使用 jq 过滤的搜索

# 点赞数 > 100 的推文
twitter search "AI safety" --max 20 --json | jq '[.data[] | select(.metrics.likes > 100)]'

# 仅提取文本和作者
twitter search "rust lang" --max 10 --json | jq '.data[] | {author: .author.screenName, text: .text[:100]}'

# 互动最多的推文
twitter search "topic" --max 20 --json | jq '.data | sort_by(.metrics.likes) | reverse | .[:5] | .[].id'

排名过滤器

过滤功能是可选的。使用 --filter 启用：

twitter feed --filter
twitter bookmarks --filter

错误参考

限制

• 仅支持图片 — 尚不支持视频/GIF 动画上传（图片上传支持 JPEG/PNG/GIF/WebP）
• 无私信功能 — 无法发送或接收私信
• 无通知功能 — 无法读取通知
• 无投票功能 — 无法创建投票
• 单账户 — 一次只能使用一组凭证
• 点赞是私密的 — 自 2024 年 6 月起，Twitter/X 将所有点赞设为私密。twitter likes 仅适用于你自己的账户

安全注意事项

• 写操作内置了随机延迟（1.5–4 秒）以避免速率限制。
• TLS 指纹和 User-Agent 会自动与使用的 Chrome 版本匹配。
• 不要要求用户在聊天记录中分享原始的 cookie 值。
• 优先使用本地浏览器 cookie 提取，而不是手动复制/粘贴密钥。
• 智能体应将 cookie 值视为秘密（不要不必要地回显到标准输出）。

每周安装量

204

代码仓库

jackwener/twitter-cli

GitHub 星标数

2.1K

首次出现

2026年3月9日

安全审计

Gen Agent Trust HubWarnSocketPassSnykFail

安装于

opencode192

codex191

gemini-cli190

cursor190

github-copilot190

cline190